Beefy Boxes and Bandwidth Generously Provided by pair Networks
Syntactic Confectionery Delight

Re^3: keywords versus variables

by BrowserUk (Pope)
on Sep 06, 2007 at 14:53 UTC ( #637446=note: print w/ replies, xml ) Need Help??

in reply to Re^2: keywords versus variables
in thread keywords versus variables

but maintenance gets hard when they aren't evocative.

Not so.

Did you ever see music annotated with: "This_is_the_second_demi_semi_quavar_in_the_third_bar_of_fifth_stanza" (*).

Or a resistor on a circuit diagram annotated: "This_is_the_470_ohmm_resistor_that_impedance_matches_the_output_of_the_third_stage_amplification_to_the_fourth_stage_feed_back_loop". (**)

(*)I've no idea if that makes sense, but a musician would.

(**)Ditto; but an electronics engineer would.

Short variable names in context are just as clear to the maintanence programmer, and often more so, than long, overly descriptive ones--if the programmer has familiarised themselves with the purpose of the routine of which they are a part.

And if he hasn't, he should not be maintaining the code.

Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.
Comment on Re^3: keywords versus variables

Log In?

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

How do I use this? | Other CB clients
Other Users?
Others about the Monastery: (3)
As of 2016-05-02 02:05 GMT
Find Nodes?
    Voting Booth?