Re: Missing package documentation reminder

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