Re: Missing package documentation reminder
| From: | Helgi Þormar Þorbjörnsson | Date: | Sat, 11 Nov 2006 20:57:48 +0000 |
| Subject: | Re: Missing package documentation reminder | ||
| References: | 1 2 3 4 | Groups: | php.pear.dev php.pear.qa |
| Request: | Send a blank email to pear-qa+get-4062@lists.php.net to get a copy of this message | ||
Obviously I sent this to the wrong ML, sorry.
On Sat, 11 Nov 2006 18:04:47 +0000, Helgi Þormar wrote:
> On 11/11/06, Sebastian Nohn <sebastian@nohn.net> wrote:
>> 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.
>
> I'm not sure you actually read the whole thing (especially since you
> quoted a very odd section of my email), never said I was against the
> rules ... the QA doc reminder thing actually contradicts those rules,
> that was my beef, Greg already came up with good solutions to this
> whole thing, so no worries, tho I still haven't heard from Christian
> about those suggestions.
>
> - Helgi
--
There are no stupid questions, only stupid people