List Info

Thread: Missing package documentation reminder




Missing package documentation reminder
user name
2006-11-11 18:04:47
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

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

Missing package documentation reminder
user name
2006-11-13 07:34:34
Helgi,

> whole thing, so no worries, tho I still haven't heard
from Christian
> about those suggestions.
I will modify the script to send mails regarding stable
packages only.

-- 
Regards/MfG,
Christian Weiske

[1-2]

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