4 ms·
All people who write bad code write bad comments = / = All people who write good code write good comments/don't need them.
by Fomite 10y ago
All people who write bad code write bad comments = / = All people who write good code write good comments/don't need them.
- lisivka 10y agoYeah, «why you need comments? just read the code» (c) Brainfuck developers.
- kyberias 10y agoWell, the point is that people who write good, clean code don't need to comment their code extensively. They don't need to continuously explain why they did some horrible hack or some trivialities because their code is well structured and very easy to understand based on other good software development practices. They don't write the requirements of their functions as code comments, rather they write unit tests that document the requirements etc.
- Fomite 10y agoI think this ignores the idea that code also has context to it, and that comments even in elegant code are useful not for documenting how a bit of code works, but why that particular thing was done.