Re: Missing package documentation reminder
| From: | Sebastian Nohn | Date: | Sat, 11 Nov 2006 07:48:15 +0000 |
| Subject: | Re: Missing package documentation reminder | ||
| References: | 1 2 | Groups: | php.pear.qa |
| Request: | Send a blank email to pear-qa+get-4060@lists.php.net to get a copy of this message | ||
Helgi Þormar wrote:
> Btw. it's "stupid" to say a package is useless without docs because that's
> simply false information :) even tho only the devs will see these
> emails, especially when the package is marked as beta, if those emails are
> going to be sent out then please do so only on stable package where I'm
> actually listed ... Use the database, not an outdated package.xml file (it
> even seems a bit of wasted cycles to use the package xml because we have a
> DB for this stuff)
PEAR rules are that a stable package needs a documentation, and that is
fine, as only very few packages are self-explanatory by reading the
code. Good software needs documentation and QA. I suppose, this is the
reason, why it is required by the rules.
Sebastian