Re: Why write the docs?
| From: | Arnaud Limbourg | Date: | Sun, 20 Apr 2003 10:37:40 +0000 |
| Subject: | Re: Why write the docs? | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-15254@lists.php.net to get a copy of this message | ||
The build process is down at the moment. It's been down for a long time but if you want to
stand up and make it work again please do so.
Mika and Xavier are running build processes atm. A temporary measure would be to have a link to
those builds.
Arnaud.
> 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...'?