
I was asked to delete my comments before committing
I was asked to delete my comments before committing I've worked in IT for 12 years now — as a full-stack developer and lead dev. Recently I was confronted with a problem I had never faced before in my career: my team members asked me to remove all my comments before committing code. We discussed this. Some of them believe that the presence of comments in code almost always indicates that the code isn't clear enough on its own, and that this is therefore a sign that it needs to be rewritten so that comments are no longer necessary. And I get that. I've read Clean Code . I've adopted some of the principles described in the book. But I've also read A Philosophy of Software Design , and what I read about the concept of deep modules versus shallow modules really resonated with me. That's not the focus of this article, so I won't say more about it — except to note that the debate over the use of comments isn't over in our profession (will it ever be?). Back to the situation. I explained to m
Continue reading on Dev.to
Opens in a new tab



