• bleistift2@feddit.de
    link
    fedilink
    arrow-up
    30
    arrow-down
    4
    ·
    1 year ago

    Hot take: Even these ‘useless’ comments help, since they relieve you of the burden of reading the code itself, even if it’s trivial. One line of English is easier to parse than one line of trivial code.

    • sznio@lemmy.world
      link
      fedilink
      arrow-up
      15
      arrow-down
      2
      ·
      1 year ago

      Yep.

      But reading one outdated line of English is worse than reading 5 lines of code and seeing the true picture.

      • pizzaboi@lemm.ee
        link
        fedilink
        arrow-up
        6
        ·
        1 year ago

        Or, if you’re my manager, there’s just one comment at the top that says “for pizza”

      • bleistift2@feddit.de
        link
        fedilink
        English
        arrow-up
        3
        arrow-down
        1
        ·
        1 year ago

        I don’t feel like “ditch comments” is the right solution to “we {forget, don’t care enough} to update comments”.

    • Rumo@feddit.de
      link
      fedilink
      arrow-up
      3
      ·
      1 year ago

      Exactly! Maybe i’ve never seen a Pizza Box before. For you your code may be trivial. But for someone else an “open before eating” helps a lot.