EML

Moving milestone. James still needs to complete this for the 2.0.0 release.

I've been working on this and should have a draft ready in a couple of weeks -
I'll call for additional favorite FAQ's soon.

James

Excellent. And thanks. Can you attach what you already have to this bug so that
we can provide feedback? Also, we decided today on the EML conference call to
aim for Sep 6 as the deadline for the next EML release contributions, with the
actual release going out on Spetember 13. Any chance you could have it ready by
Sep 6?

OK, but remember you asked for it - I'm still working from my yellow pad notes
and I haven't formatted it in XML yet but here it is. I'll try to have a
formatted version with a little polish by Friday 30 Aug. I'll take any
favorites you have - answers which I'll wordsmith are also most welcom.

I've added another page of questions from my yellow pad and some more answers.
Still unedited for the most part. Since I don't know if my previous comments
will be deprecated I will repeat them - I'm shooting for an XML formatted
version that is somewhat polished by Friday 30 Aug - send any favorite
questions and any favorite answers. TNX

James -- excellent start. I read it over and all of the questions are great.
The answers are good too :) Some of the answers are trivially out-of-date -- we
can make those technical corrections once you submit the initial text XML
document into CVS as a draft. What XML format are you going to use? I think
Docbook has some suggested tags for FAQ entries.

I would appreciate suggestions on the formatting. I have this homegrown one that
Matt did that I can modify to have section identifiers but if someone has
something more standard I'd appreciate it.

<faq version="1.1">
<faq-item id="1">
<question>Why does it rain?</question>
<answer>Because it is wet.</answer>
</faq-item>
</faq>

I've added some more text and formatted the document. I've got a lot of editing
and polishing and some more answers to make up but I wanted to get this up
before I head out for the long weekend.

I've checked the first real draft into cvs for comments, formatting, additions,
etc. I'm hoping someone will take on the formatting and provide a template for
the further development and maintenance. There needs to be provisions for
subsectioning I think because I can see questions developing along several
lines. I won't close out this bug until we have a real working version that the
group feels is acceptable for publication. - James

James -- I'll develop an XSLT stylesheet to produce XML from your faq that can
be linked into the EML docs. I agree sections are probably in order. I added
eml-dev to the cc list for this bug so that people would know to review the new
FAQ that you created. I think there are still some minor inaccuracies we'll
want to clean up, but its looking great! Thanks.

I changed the format of the xml in the faq to docbook, then I changed the
build.xml file to use the docbook xsl stylesheets. I also added a couple more
questions to the faq. the faq can no be formatted to html using the command
'ant faqhtml'.

Chad, this looks great. Being not familiar with Docbook can you tell me how to
insert sectioning into the QandA feature?

you can put any docbook inline elements into those question and answers. See
http://www.docbook.org/tdg/en/html/docbook.html for a complete reference on the
docbook elements. I think you would just use <para> and lists to section the
questions and answers how you want. It depends on where you want to put the
sectioning though.

Completed for RC1 release. Reviewed and revised by jones and berkley. Ready to
ship. Thanks James. FIXED.

Original Bugzilla ID was 495