Pile on Ohloh for POD support

schwern on 2008-01-03T07:08:25

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!


Which is it?

kaare on 2008-01-03T10:52:09

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?

Re:Which is it?

schwern on 2008-01-03T12:46:50

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.

Re:Which is it?

jplindstrom on 2008-01-03T14:43:05

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?)

Re:Which is it?

schwern on 2008-01-04T03:43:00

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.