On 05/09/2011 19:54, Uri Guttman wrote:
it doesn't matter the language or the comments. single letter var names are just bad coding. names are a communication to the reader of the code, not a placeholder or whatever to the coder. much more work needs to be put into choosing good names than most coders realize. it is one of the major characteristics i look for when i review code (and i review a ton of code for my business of place perl hackers).
I would counter with the thought that lack of capitalisation is just poor-quality and bad-mannered writing. Capitals provide a focus for the reader to understand the meaning of what has been written without having to examine every word, just as the serifs on a properly-chosen body text font lead the reader to the next symbol. Much more work should be put into your literary style than you realise, as your documentation and comments will be your sole means of communication to all who have site of your code while you are not there to explain it. I am certain that no one who is unable to format and punctuate their own written language properly can possibly imagine how to write software that is both functional and comprehensible. Rob -- To unsubscribe, e-mail: beginners-unsubscr...@perl.org For additional commands, e-mail: beginners-h...@perl.org http://learn.perl.org/
