On 17 Jun 2004, at 11:41, khemir nadim wrote:
[snip]
OK. but a module without a readme with meaning ful content, a minimum of
documentation is not "anything" it's "nothing" so I'd say it's OK to not
allow "nothing" to get into CPAN.
[snip]

Tosh ;-)

If I removed the README file from one of my CPAN modules would it suddenly become "nothing"? No.

A distribution without a README is perfectly usable, maybe slightly less usable than one with a README, but still usable.

Personally I've had more problems with out of date and inaccurate READMEs than I have with absent ones. In fact I can't remember the last time I looked at a README file - the POD's always my first port of call, followed by META.yml, Makefile/Build.PL and the test suite.

[snip]
The access to CPAN is not moderated in any way (my anarchist side likes
that) but maybe a minimum of control wouldn't hurt (my fascite side like
that)
[snip]

Since I don't think anybody else has mentioned it you might find Jarkko's "The Zen of Comprehensive Archive <http://www.cpan.org/misc/ZCAN.html> an interesting read. Two excerpts:

        "adding any rating or approval processes creates bottlenecks, and
        bottlenecks are bad"

        "There is no magic. All it takes is a few people that sit down
        and get first something running, a rough cut. Then iteratively enhance
        it. Don't try to create a master plan that will get everything right
        in one fell swoop. The only one that will get swooped is you."

Cheers,

Adrian



Reply via email to