List Info

Thread: Missing package documentation reminder




Missing package documentation reminder
user name
2006-11-11 20:57:48
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 <sebastiannohn.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

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub
.php

[1]

about | contact  Other archives ( Real Estate discussion Medical topics )