Why write the docs?
| From: | Alexey Borzov | Date: | Sun, 20 Apr 2003 10:32:37 +0000 |
| Subject: | Why write the docs? | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-15253@lists.php.net to get a copy of this message | ||
Greetings!
OK, I keep hearing how world would be a better place if every PEAR package has documentation. So I downloaded "DocBook: The Definitive Guide", checked out peardoc, tried to use phpDocumentor with a peardoc2 converter...
And then I looked closely at PEAR website and found out that documentation was last generated on 26th of January.
So, lets imagine that I do write the docs in DocBook and even commit them. Will they appear on the website in human-readable format anytime soon, or should I tell the people interested in the docs: 'They are in there... Sorta... You only have to checkout peardoc, read the phpdoc-howto and build them for yourselves...'?