develooper Front page | | Postings from June 2008

Re: The uselessness of arbitrary Metric gaming

Thread Previous | Thread Next
June 30, 2008 15:08
Re: The uselessness of arbitrary Metric gaming
Message ID:
On Monday 30 June 2008 15:03:14 David Cantrell wrote:

> On Mon, Jun 30, 2008 at 11:42:23PM +0200, Aristotle Pagaltzis wrote:

> > (The problem is that one of the aspects of kwalitee was supposed
> > to be that the module is properly documented ??? regardless of how
> > good the documentation is, it should follow proper form, at
> > least. Unfortunately, since a design goal for CPANTS is not to
> > run any code from the distro, testing POD coverage and even POD
> > itself is not actually doable because you don???t know what the API
> > will look like at runtime (AUTOLOAD, autogenerated functions or
> > methods, etc etc etc).

> Surely you can at least check that all POD is "well-formed" without
> running any code from the distribution in question?

Sure, but that's a very different question from "Did the author write useful 
documentation for everything that needs public documentation?", as "Are there 
any POD errors?" is statically determinable.  "What do useful, proper, 
public, and everything mean?" is not.

-- c

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About