In the last post (Coding Style: Terse vs Verbose), I laid out some of the arguments for and against a verbose coding style and a terse coding style. Although, I didn’t delve deeply into what I meant by these styles, I hoped the details were less important than the general feel. However, by the end… Read More »
One coding style issues that causes many arguments is the distinction between the Terse/Elegant/Succinct style and the Verbose/Legible/Debuggable style. As usual, each side explains that their style is the only rational choice and that the other approach is obviously wrong. First, let’s look at the two styles to see what they say. In order to… Read More »
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 »
In the comments on a recent Google+ post, a discussion erupted about comments in source code. As usual, there were two groups that argued relatively vehemently. The More Comments camp was best represented by the suggestion that a good program should have as many lines of comments as lines of code. The Clear Code Needs… Read More »
Perl Best Practices Damian Conway O’Reilly, 2005 This book is hard to summarize. There is much good advice in this book. Unfortunately, there’s also some advice that I found questionable. Conway covers some of important Perl programming and general programming best practices, including consistent formatting, use of strict and warnings, and the use of version… Read More »
In the book Software Exorcism, Bill Blunden described a problem caused by the maintenance programmer not usually being the same person as the programmer who wrote the code. Often the maintenance programmer comes in with a less-than-complete understanding of the original problem or of the design decisions made for this problem. Usually, there are also… Read More »
Perl for Web Site Management John Callender O’Reilly, 2002 This book may be one of the best books I’ve ever seen for getting the Perl programming language used in a place where it is sorely needed. Many people developing web-based applications are not programmers. They learned to use some HTML authoring tool and progressed from… Read More »