There's a lot of discussion among coders about comments, some say that good code shouldn't need commenting.

But the thing a lot of people fail to understand with comments is that you don't just want to say what th code is doing. But why. The why is often more important. I have a code base I've taken over maintenance of, and in the execution there's a 60 second delay in there. But there's no details of why. What breaks if I remove it? Do I want to find out the hardway?

@quixoticgeek Also, high quality commit messages in (VCS of choice)...

@quixoticgeek Only if the lines following it are an explanation of why FFS :D

Follow

@twigathy why. Cos git...I thought that was implicit...

· · Web · 0 · 0 · 0
Sign in to participate in the conversation
(void *) social site

(void*)