alex <[EMAIL PROTECTED]> wrote: > Firstly lets set up a mailing list for discussing Apache FAQs. I think it > would be a Good Thing.
I think public discussions relevant to the FOP FAQ could be held on this list, everything else by email. Or did you think of a discussion on how to do FAQs in general? > AFAIK there is no official XML schema or DTD for FAQs, but we can come up > with one. > There is something called "xdocs" which is what most Apache documentation > is written in. I am not sure if it is suitable for FAQs. There is a docs/xml-docs/fop/faq.xml, the structure of which, however, doesn't quite match neither the source nor the result of docs/xml-docs/stylesheets/faq2document. Nevertheless the structure given by the mentioned style sheet is not unreasonable. An interesting alternative would be DocBook qandaset. I wouldn't have trouble providing any of the formats. DocBook comes with markup for indexing, which is valuable for a FAQ. > HOWEVER do we want the FAQ in the CVS tree? It means that it is a lot > harder to add new answers. I don't think using CVS automatically makes it harder to update the FAQ. We just have to set up the publication process properly. Of course it's easier if just one person uses only the ressources at his disposal. Some possibilities: 1. Update the FAQ in the docs subdirectory. Of course, changes in the CVS should be mirrored by publishing the generated HTML on xml.apache.org/fop. Actually, who does this publishing currently? 2. Provide a separate branch or even a CVS project for the FAQ 3. No CVS. In either case, we will have to agree on responsibilities and set up an event mechanism so that the publicly visible FAQ is kept in sync with what's archived somewhere. I personally would like to work on the FAQ distributed with FOP and published on xml.apache.org/fop. The server is reliable, and we would have a FAQ in the distribution which is in sync with the distributed code. Questions: - Who is currently responsible for publishing FOP docs on xml.apache.org? - Whom and by which mechanism should i send the material or notifications about changes in the repository? Possible mechanisms: Email, FTP upload, CVS checkin. - Who will be responsible for transforming the XML source into the publishing format? - Where will the ultimate source be archived? (N/A in case of CVS) > <plug>Anyone in London or nearby want some FOP consultancy?</plug> I've some experience to sell as well... Regards J.Pietschmann --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, email: [EMAIL PROTECTED]
