I assume most of your comment your code.
Well, you probably comment code most of the time.
I’d bet your comments have quite a bit of detail.
And you do this completely inconsistently.
That’s what I’d think, or maybe just what I want. Even the best developers I know will not consistently comment code. You can drift through any project on Github and see this. Those projects on GitHub might even be better documented because people know they are public. In most corporate environments I have worked in, I’ll find that when people get busy, or distracted, or even when they’re experimenting to find a solution, and they don’t write detailed comments. Usually only when someone fixes a bug, with a solution found quickly, do I get a really useful comment.
There are all sorts of ways that people think about commenting their code. I ran across a post from…
View original post 254 more words