Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris  Re^3: Code Maintainability  by
doom (Deacon) on Dec 07, 2008 at 00:02 UTC
( #728617=note: print w/ replies, xml ) Need Help??  in reply to
Re^2: Code Maintainability in thread Code Maintainability  I've
never had to work with one of the legendary "comment every line"
types -- it could be they don't get hired at the kind of places
I've worked.  From skimming tilly's example here: [Text::xSV] I
would summarize that he likes sparse, higher-level comments, but
with very verbose error messages that actually function fairly
well as substitutes for comments. At a glance it does seem that
both variable names and sub names are a bit short, but then,
they don't strike me as confusing. He also likes pod-at-the-
bottom style which also comes recommended by Conway in his "Best
Practices" (I'm a fan of interspersed-pod style, myself, but not
so much that I'd insist it's the One True Way).  By the way: if
the main objection to co