We've written before about the value of writing your README before your code, but what about when it comes to the actual code? Terse one-liners? Paragraph-long descriptions? How much is enough and ...
Peter looks at how rewriting some complex code -- purely to make it easier to read -- eliminates the need for writing comments. He even adds a comment to some code. In a previous column, I discussed ...
Just ask the developer is literally the worst advice you can give. 1) The developer may not be around a few weeks or months from now. 2) You are wasting 2 people's time here. 3) The Dev reading the ...
Recently I was intrigued by Joe Kunk's On VB column about commenting code. I especially liked Kunk's comment that: "It's important to communicate what the code should be doing." I thought that was the ...
Some comments saying what the code does and why would go a long way to making my life easier. Time is money and programmers who don't comment care costing their employer money because what should take ...