Michael G Schwern <[EMAIL PROTECTED]> wrote:
> I'd like to propose two simple critereon for all future module
> additions to the core:
>
> 1) It has a reasonable amount of POD documentation. At minimum it
> must have something, even if its just a NAME, SYNOPSIS and
> DESCRIPTION.
This is arbitrary. I don't disagree that it's a must, but it might be
better to qualify this out a bit to see how this might work. I do,
however, think that it would be a good absolute to have a requirement of
standard internal documentation, not just for the core, but to CPAN as
well. Currently, a lot of authors are recklessly putting in documentation
in HTML files, readme's, etc. which makes building a PITA since special
steps have to be taken to get this help to any end user of a compiled
collection (and if you compile them yourself, you need to be aware of
every module author's individual idiosyncracies). I've been begging Dave
Roth for four years now to actually put documentation for ODBC.pm into
ODBC.pm (among several others). "Reasonable amount", however, is
arbitrary. Please qualify it.
> 2) It has a reasonable amount of tests. Minimum must be more than
> simply a compile test.
Although I fail to see any problem here, I know one's going to pop up. It
sounds like an absolute where one isn't needed. For example, for a
previous employer, I spent two months writing a Y2K perl testing suite to
sell to high-priced companies to prove that their Perl was Y2K safe. Of
course, the boss and I both knew that we were wanting to charge a lot of
money for basically saying if(0){you have a y2k problem in the Perl
core)... I'm sure there will be items where testing would be superfluous
or misleading.
> What is "reasonable" in each case is ultimately left up to the
Pumpking.
Always qualify your suggestions in group posts, please. The P5P may be
used to working as an oligarchical monarchy, but the P6 groups have a
happy democracy with only an occasional trump from above. Having abstained
from the P5P for so long, it's been a long time since I've seen a
suggestion with no content.
p
