Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

schwern (1528)

schwern
  (email not shown publicly)
http://schwern.net/
AOL IM: MichaelSchwern (Add Buddy, Send Message)
Jabber: schwern@gmail.com

Schwern can destroy CPAN at his whim.

Journal of schwern (1528)

Thursday January 03, 2008
02:08 AM

Pile on Ohloh for POD support

[ #35271 ]

Ohloh doesn't recognize POD. This results in things like MakeMaker being dinged for having too few comments when in fact it's over 40% comments and POD.

If a mere 11% of the code is comments, Ohloh considers that to be "well-commented". In the Perl world that's low, 20-40% is more the CPAN average. Perl should be allowed to stand on it's own merits, so please pile onto the suggestion that Ohloh start tracking POD (be polite) and we can show the other languages how it's done.

11%. Pfft!

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • So is this because Perl developers write more documentation?

    Or because Perl is so much more efficient that the actual code just aren't that many lines of code for the same functionality?
    • I think little bit of both. Certainly having a built-in, embedded documentation language helps a lot. Plus CPAN means every project has the same potential to be seen, patched and critiqued allowing best practices to quickly disseminate.
    • Or is it that POD is slightly (not a lot, but still) more verbose than just comments, with all the blank lines?

      (Or are they not counted?)
      • Their metrics are screwy, but it appears that currently POD is counted as Perl if it's in a .pm file. Blank lines are counted as blank lines.