It was decided at the PHP Documentation Meeting at LinuxTag to go with livedocs as the solution for almost all of the PHP documentation problems.
This is great news for all involved - thanks to Derick Rethans and Ilia Alshanetsky for their contributions!
Wez Furlong in
Docs.
Having been frustrated by the length of time that it takes to build the substantial PHP manual from its XML sources (45 minutes or so), I hacked together a nice simple but effective tool (using PHP, of course!) to index the DocBook sources (takes less than 2 minutes), and transform the XML into HTML on-the-fly.
You only need to re-index the content if you add a new node or a new XML file. Any changes you make to your docs are then "instantly" visible in your browser.
Wez Furlong in
Docs.
Wez Furlong is Director of Engineering at Message Systems where he works on the fastest MTA on Earth.
Wez is a PHP Core developer and active OpenSource contributor. He currently resides in Sykesville, Maryland with his wife, son, and dog. (read more)
Subscribe.
(circulation 804)
Comments.
(circulation 7)
