Comment xml documentation (Score 1) 583
we just wrote a web app which uses xml/xsl processing to create web pages, so decided to write the docs in xml too. nice text based format for the doc, easily readable & updateable by us, easy to version control etc.
we use xalan/xerces from xml.apache.org to transform the xml into pdf/html using xsl/fop for presenting to users etc - bit of work setting it up, but we'd done most of it already for the app so it wasn't much work, and now its set up its a lovely method, just edit the xml and run a script to output to pdf/html.
anorakgirl
ps i do think we have a habit of doing things the long way round though, sticking with text editors & scripts rather than using ready made apps... :)
we use xalan/xerces from xml.apache.org to transform the xml into pdf/html using xsl/fop for presenting to users etc - bit of work setting it up, but we'd done most of it already for the app so it wasn't much work, and now its set up its a lovely method, just edit the xml and run a script to output to pdf/html.
anorakgirl
ps i do think we have a habit of doing things the long way round though, sticking with text editors & scripts rather than using ready made apps...
