• hex@programming.dev
    link
    fedilink
    arrow-up
    0
    ·
    edit-2
    1 month ago

    Yeah. I advocate for self explanatory code, but I definitely don’t frown upon comments. Comments are super useful but soooo overused. I have coworkers that aren’t that great that would definitely comment on the most basic if statements. That’s why we have to push self explanatory code, because some beginners think they need to say:

    //prints to the console
    console.log("hello world");
    

    I think by my logic, comments are kind of an advanced level concept, lol. Like you shouldn’t really start using comments often until you’re writing some pretty complex code, or using a giant codebase.

    • Faresh@lemmy.ml
      link
      fedilink
      English
      arrow-up
      0
      ·
      1 month ago

      Comments are super useful but soooo overused

      I think overusing comments is a non-issue. I’d rather have over-commented code that doesn’t need it, over undocumented code without comments that needs them. If this over-commenting causes some comments to be out of date, those instances should hopefully be obvious from the code itself or the other comments and easily fixed.

      • hex@programming.dev
        link
        fedilink
        arrow-up
        0
        ·
        1 month ago

        I understand what you’re saying and I mostly agree, but those few instances where a line of code is only slightly different and the comment is the same, can really be confusing.