Comment on [deleted]

• Traister101@lemmy.today ⁨1⁩ ⁨year⁩ ago

  Always comment the why, not the what

  source
• NegativeLookBehind@kbin.social ⁨1⁩ ⁨year⁩ ago

  git blame

  source
• Savaran@lemmy.world ⁨1⁩ ⁨year⁩ ago

  If the comments don’t match the code then someone failed to properly review it.

  source
• MajorHavoc@lemmy.world ⁨1⁩ ⁨year⁩ ago

  Lol. That’s why we comment with “why”, rather than “what”. The answer to “what the duck where we even thinking?” usually doesn’t need updated until the commented code goes away.

  source
• Suppoze@beehaw.org ⁨1⁩ ⁨year⁩ ago

  Never understood this argument, it’s the person’s responsibility who change the code to update the comments if needed. Otherwise they just implicitly admit that they did not read it and understand the context, or just plain does not care.

  source

  • sebsch@discuss.tchncs.de ⁨1⁩ ⁨year⁩ ago

    It just never works. Its important documentation breaks if changes are made. The best docs are baked into unittests

    source