My wife is a really good writer and she once gave me a great piece of advice for some documentation I was working on: Know Your Audience. This has helped me to write better documentation. Over the years, I have come to realize that the same advice applies when writing code. Who is the Audience… Read More »
Code Reading Diomidis Spinellis Addison-Wesley, 2003 I have had this book on my list of books to read for some time. Although I have been reading code for years, everything I had heard about this book suggested that it would help improve my reading skills. Unfortunately, halfway through the book I was mostly disappointed. This… Read More »
Like any natural language, most programming languages support idioms. According to the American Heritage Dictionary of the English Language, an idiom is A speech form or an expression of a given language that is peculiar to itself grammatically or cannot be understood from the individual meanings of its elements, as in keep tabs on. A… Read More »
And just to prove that some ideas appear in many places all at once, Andy Lester explores naming again in O’Reilly Network: The world’s two worst variable names [Mar. 07, 2004]. Apparently, Lester is reviewing the second edition of Code Complete, one of my favorite books on programming, and says there is an entire chapter… Read More »