September 2021


Today we are going to talk about writing code comments. I will share my view on comments and provide you with some best practices (or worst?) for commenting code. Why do we write code comments? In theory, we use comments to explain some complex or not clear enough parts of our code. We aim to make them easy for understanding for the other developers and us in the future. Everything sounds great, but in practice, things get a lot different. Reality shows that we often write comments to explain a poorly written code that we are lazy to refactor. That’s…