• Ftumch@lemmy.today
    link
    fedilink
    arrow-up
    37
    ·
    edit-2
    3 days 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
      13
      ·
      3 days ago

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

      • hakunawazo@lemmy.world
        link
        fedilink
        arrow-up
        1
        ·
        1 day ago

        A software tester walks into a bar

        Runs into a bar.
        Crawls into a bar.
        Dances into a bar.
        Flies into a bar.
        Jumps into a bar.

        And orders:

        a beer.
        2 beers.
        0 beers.
        99999999 beers.
        a lizard in a beer glass.
        -1 beer.
        “qwertyuiop” beers.
        Testing complete.

        A real customer walks into the bar and asks where the bathroom is.

        The bar goes up in flames.