Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic
 
PerlMonks  

Re^2: Perldocs and peer reviews

by g0n (Priest)
on Jan 31, 2005 at 14:25 UTC ( #426604=note: print w/ replies, xml ) Need Help??


in reply to Re: Perldocs and peer reviews
in thread Perldocs and peer reviews

The problem with that is that it's possible for the docs to be clear, seem complete, and describe friendly syntax... and be wrong

Which of course a doc review would not highlight. But normal testing and use would.
I'm not advocating POD review as a replacement for functional testing, but as a way to get more people involved in distribution QA in a way that is easier and more accessible than performing full blown testing, and getting a 'first pass' done on a wider range of modules.
After all, full testing on every module on CPAN is well nigh impossible, but if we could get a POD review on a wider range, that would be better than nothing.

VGhpcyBtZXNzYWdlIGludGVudGlvbmFsbHkgcG9pbnRsZXNz


Comment on Re^2: Perldocs and peer reviews

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://426604]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others wandering the Monastery: (9)
As of 2014-12-26 14:31 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (171 votes), past polls