5 ms·
I like it, I comment exactly like you do. Comments are free, storage is plentiful, why not add comments everywhere?!
by ok_dad 1y ago
I like it, I comment exactly like you do. Comments are free, storage is plentiful, why not add comments everywhere?!
- Shraal 1y agoTime and risk of comments/docs becoming outdated and doing more harm than good. I'm impartial in this discussion but that's usually how the counter argument goes.
- ok_dad 1y agoThe counter argument is bunk, you change the comments when you change the code. It’s not hard. If you forget, them a reviewer will notice. If not, then you aren’t focusing enough attention on the finer details of a project, to your detriment. Personally, I find that a lot of good, accurate comments and documentation helps me to trust a code base more because I can see that the devs cared and focused on the finer details rather than just tossing code over a fence at me.