That is all it takes to explain what you are doing, why you are doing it, how you are doing it and where you will do it.
It’s not rocket science, it’s not complicated, it doesn’t add hours to your coding effort and in some cases it has the potential to be an added dose of humour to your fellow colleagues as you work through a particularly stressful problem.
Comments were put to me in the best way possible years ago…
Imagine the person behind you is a Crazed Serial Killer and your lack of comments will be the tipping point for them.
Comment your code not only for your team, but for yourself, so you remember why you wrote it, what stress you were under and why it shouldn’t be refactored.
Dynamics Plugins and