PEAR Docs... again

Pears, I have been thinking a little today. It hurt, I won't do it again rest assured. I have been wondering if anybody is interested in this: Write you documentation as nice (easy) HTML of the form: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Package Name</title> </head> <body> <h1>Section Name</h1> <p> Section stuff. </p> <code> <?php echo "Some Example"?> </code> <h1>New Section</h1> <p> More section stuff </p> <h2>Sub-Section Name</h2> <p> even more section stuff </p> <h2>Second Sub-Section Name</h2> <p> yet more section stuff </p> </body> </html> You then upload your documentation as a tar(.gz?) file to a website. This nice, easy HTML, will be automatically converted to DocBook using the new PHP5 XSLT stuff - with the ability to call PHP functions, I can output to the seperate files/generate TOC and such that is needed. The DocBook is then validated on the server, so you don't need to worry about that. If its valid, the results will be served to you as a .tar.gz (or if the validation takes a little while, you will be mailed a link to the .tar.gz) This seems like at the very least, another good solution to contribute to solving the Documentation problem... Thoughts? - Davey