I've been saved countless of times by people who document their code, and also doomed by people who doesn't. At some point I just started to love comments, even the most redundant ones. I strongly believe that a comment is never wrong, unless outdated or misleading.
Sadly not much people seems to like this stance. Instead of documenting our functions, we rely on the naming convention and writing expressive code to figure out the
what and the
why of any code. Sometimes we even have aesthetic troubles with it, as if the comments were distracting us from the code itself.
I like to write expressive code, but I don't see it as a replacement of proper documentation.
Am I doing it wrong?