December 2008 Blog Posts
I just needed to find where to moderate them from. I suspect my geek card is now probationary.
My opinion on inline comments is similar to my opinion on demolition charges; they're useful in exceedingly rare circumstances but if you use them all the time there's probably something wrong. Lots of inline comments do not maintainable code make. Their usage can generally be classified into the following categories: Repeating what the code says. There's already something that says what the code does, it's called the code. Repeating what the code used to do. If you work on a team where inline comments are regularly and consistently updated to match the...
Things I'm aware of about my own writing: I use far too many commas I have a tendency to go into way too much detail about points tangential to my original point My spelling is atrocious but mostly masked by spell check I have no idea what circumstances the colon and semicolon are appropriate for I tend towards the opinionated (often from the very opinionated) I can be overly verbose I often include qualifications, either due to or...