jorty (deprecated aspect) @jordyd@octodon.social
Follow

Good code comments don’t mean “explain everything happening in the code”. It means:
- summarize the intent of an upcoming code block
- clarify the meaning of confusing code
- clarify the meaning of counter-intuitive code

If you put too many comments, it becomes hard to tell an important comment from an unimportant one.