Beefy Boxes and Bandwidth Generously Provided by pair Networks
Just another Perl shrine
 
PerlMonks  

Re^2: Practical example of "Is Perl code maintainable"

by Anonymous Monk
on Aug 22, 2012 at 20:56 UTC ( #989144=note: print w/ replies, xml ) Need Help??


in reply to Re: Practical example of "Is Perl code maintainable"
in thread Practical example of "Is Perl code maintainable"

Call me wool headed, but none of the samples here look maintainable to me - for one simple reason. Not one of them contains a single comment about what the code is supposed to do or what it is actually doing. Apparently perl does not support the inclusion of comments in code. I know when I'm maintaining existing code, I like to have to act like a language interpreter in my head to determine what a bunch of code is doing - comments are for noobies.


Comment on Re^2: Practical example of "Is Perl code maintainable"
Re^3: Practical example of "Is Perl code maintainable"
by runrig (Abbot) on Aug 22, 2012 at 21:14 UTC
    Call me whatever you want to, but the example you've just replied to looks about as close to self-documenting as it gets.
Re^3: Practical example of "Is Perl code maintainable"
by Your Mother (Canon) on Aug 22, 2012 at 21:29 UTC

    I wouldn't call you names but–

    1. Of course Perl has comments.
    2. Besides taking up space and concentration, comments drift and end up being lies or broken crutches a lot. They should only clarify what the code and the Pod (and the unit tests for that matter) cannot.
    3. That the code presented isn't runtime application of composed roles and mixins built dynamically with business logic stored and versioned in the DB, it's a basic file check one perldoc away. It doesn't warrant even a correct comment.

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others imbibing at the Monastery: (6)
As of 2014-12-18 04:12 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

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





    Results (41 votes), past polls