Et al,
I'm interested in either designing or participating in a current project which utilizes PHP and XML to create a documentation application. My company (caravelcms.org) has designed a content management system using PHP and we are currently investigating how we can document effectively our various userland functions. Instead of re-inventing the wheel, I thought I'd put a call out to the PHP community to see if you could push me in the right direction. Basically, what I want is a way of writing and storing and inter-linking documentation for our application. It seems XML would be the best route to go, but I'd prefer the documentation app to also be in PHP. I'd imagine others have had a similar desire and perhaps an app is out there already.
You can use DOCBOOK (XML) to source your documentation, and then use PHP to generate the resulting XML files, or you can use any number of the "javadoc"-like php auto-documentation generators.
The PEAR syntax guide has an example to effectively document classes/methods so that phpdocumentor (and other auto-documentation generators) can create the documentation automatically. There was a similar question recently to which I (and others) posted some links to some auto-document generators.
-- Burhan Khalid phplist[at]meidomus[dot]com http://www.meidomus.com ----------------------- "Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing."
-- PHP General Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
