RE: [PEAR-DEV] Packages and documentation
| From: | Daniel Khan | Date: | Tue, 09 Sep 2003 20:54:17 +0000 |
| Subject: | RE: [PEAR-DEV] Packages and documentation | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-21290@lists.php.net to get a copy of this message | ||
Joshua Eichorn wrote:
[..]
> I think what he is saying is PEAR has a bad reputation and the reason
> isn't because of the quality of the code (at least not in most cases)
> but the quality of the documentation and surrounding infrastructure.
Where, what, why?
Reputation: Does it really have a bad reputation?
Infrastructure: What do you mean? How could we improve this?
Documentation: Right - many packages haven't a nice documentation but all
packages
I used yet provided at least a nice example.
Yes documentation is important and we don't have to discuss that again as
documentation
is required by rule.
IMHO everybody developing for PEAR, including me, knows that it's very
important.
So as time is short the only thing we could do is to provide examples and
short readme's keeping
in mind that we _have_ to do the documentation ASAP.
When a package moves into PEAR the work isn't finished.
There are feature requests, API changes, bug fixes, improvements,...
So we can't always sit back and doing documentation work.
Most of us have daytime jobs and some even have family.
It needs much time management to do open source development so sometimes
things aren't as they should be...
just my 2 cents
Daniel Khan