22

Code reviewer keeps removing my comments saying, "This will only be read by other programmers, the code should speak for itself".

<hyperbole>
This is the exact opposite to back in uni where for every line of code they demanded 2 lines of comments!
</hyperbole>

Comments
  • 1
    Ok 2:1 is a little extreme imho but there should be some comments...
  • 0
    "Write such good code you don't need comments"
  • 1
    @gintko or JavaDoc in Java/Kotlin and XML comments in C#
  • 1
    Simple rule. If you feel like you just performed just performed some genius act inspired by transcending into all knowing programmer and twisting the constraints of the programming language or you feel really sorry for the lines of code you just wrote you should probably leave a comment explaining what you've done or why you did it.
  • 2
    This is also why they encourage you to write so many comments in uni, because when you look back at the work you did in uni you will almost always feel sorry for writing it.
  • 3
    I hate such bitches! Yeah, the code speaks for itself. But it does not tell anyone why the author did exactly _that_ right _there_!
    And that's what good comments do.
    Plus comments can describe situations, states, and the current work flow.

    Damn, these idiots should go back to their academimimi and let us do our job!
  • 1
    IMHO a lot of programmers misunderstand what the comments should be. Comments that describe WHAT Is happening on every line are nearly useless and just add extra clutter. However comments that describe WHY is something done accelerate understanding of code.
Add Comment