3 ms·

The importance of the comments in COBOL reminds me of a developer I worked with who was famous for removing comments to 'tidy up the code' The other developers

The importance of the comments in COBOL reminds me of a developer I worked with who was famous for removing comments to 'tidy up the code' The other developers then spent time readding the comments

Iwan-Zotow 6y ago
> was famous for removing comments to 'tidy up the code'. The other developers then spent time readding the comments "good stable and low-stress jobs in the middle-range of local income"
- Viliam1234 6y ago
  Yep. In high-stress jobs you sometimes meet an asshole who removes the comments, but no one has time to re-add them.
ta988 6y ago
I hope you removed that dev to tidy up the team.
- ithkuil 6y ago
  I did see codebases with tons of comments saying the wrong thing. Comments (prose) are not compiled and executed and tested and can easily drift
munk-a 6y ago
There is such a thing as unnecessary comments and I only add comments myself when factors outside of the immediately visible code are effecting the logical flow... but removing other people's comments (other then auto-doc style ones) is a really bad habit. You're essentially invalidating the opinion of whoever thought it was important to put a comment there in the first place and, unless it's done after a team discussion on the types of comments to include in code, it's being done unilaterally.
wombatpm 6y ago
Comments in code are like sex. When they are good its incredible, when they are bad it’s better than nothing
- blippage 6y ago
  Sex is like a game of Bridge. If you don't have a good partner, then you'd better have a strong hand.
- samus 6y ago
  The difference to sex is that comments are unnecessary if the project is in good shape otherwise. Yes, no code is really self-documenting, but requirements documents, handbooks, documentation comments, VCS logs and tests should make it possible to elucidate weird code parts. Bad comments are detrimental: some are outdated comments that were forgotten to remove or to update, and others were wrong or misleading to begin with. Some are just redundant (they might state the obvious) and might become misleading later on. Their existence is of historical interest in the best case.
- munk-a 6y ago
  When comments are bad they can be actively misleading and when comments are everywhere they can do nothing but obscure logic. I like well commented code, but poorly commented code can be worse than uncommented code that's clearly written. Lastly, adding comments to code doesn't always add value.

The importance of the comments in COBOL reminds me of a developer I worked with who was famous for removing comments to 'tidy up the code' The other developers then spent time readding the comments

Iwan-Zotow 6y ago

> was famous for removing comments to 'tidy up the code'. The other developers then spent time readding the comments "good stable and low-stress jobs in the middle-range of local income"

Viliam1234 6y ago
Yep. In high-stress jobs you sometimes meet an asshole who removes the comments, but no one has time to re-add them.

ta988 6y ago

I hope you removed that dev to tidy up the team.

ithkuil 6y ago
I did see codebases with tons of comments saying the wrong thing. Comments (prose) are not compiled and executed and tested and can easily drift

munk-a 6y ago

There is such a thing as unnecessary comments and I only add comments myself when factors outside of the immediately visible code are effecting the logical flow... but removing other people's comments (other then auto-doc style ones) is a really bad habit. You're essentially invalidating the opinion of whoever thought it was important to put a comment there in the first place and, unless it's done after a team discussion on the types of comments to include in code, it's being done unilaterally.

wombatpm 6y ago

Comments in code are like sex. When they are good its incredible, when they are bad it’s better than nothing

blippage 6y ago
Sex is like a game of Bridge. If you don't have a good partner, then you'd better have a strong hand.
samus 6y ago
The difference to sex is that comments are unnecessary if the project is in good shape otherwise. Yes, no code is really self-documenting, but requirements documents, handbooks, documentation comments, VCS logs and tests should make it possible to elucidate weird code parts. Bad comments are detrimental: some are outdated comments that were forgotten to remove or to update, and others were wrong or misleading to begin with. Some are just redundant (they might state the obvious) and might become misleading later on. Their existence is of historical interest in the best case.
munk-a 6y ago
When comments are bad they can be actively misleading and when comments are everywhere they can do nothing but obscure logic. I like well commented code, but poorly commented code can be worse than uncommented code that's clearly written. Lastly, adding comments to code doesn't always add value.