• Ftumch@lemmy.today
    link
    fedilink
    arrow-up
    28
    ·
    edit-2
    15 hours ago

    That’s not a good comment. What it is should be clear from the naming and context. A good comment explains the why when that is not obvious:

    // This glass is at 50% capacity because we don't want it to overflow if it rains
    
    • one_old_coder@piefed.social
      link
      fedilink
      English
      arrow-up
      9
      ·
      14 hours ago

      And in 5 years you will wonder why the glass is under the rain because someone didn’t put that in the specifications.