• ChickenLadyLovesLife@lemmy.world
    link
    fedilink
    English
    arrow-up
    27
    ·
    1 year ago

    There’s a weird ongoing thing in the programming world where about half of coders think code should be well-commented and the other half not only think that code shouldn’t contain comments but also think that comments are an indicator of professional incompetence (aka a “code smell”). I’ve long noticed that the anti-commenting crowd are also the ones that can’t write very well.

      • Gabu@lemmy.world
        link
        fedilink
        arrow-up
        4
        ·
        1 year ago

        People who dislike code documentation are often overoptimizers, from my experience.

    • kicksystem@lemmy.world
      link
      fedilink
      arrow-up
      9
      ·
      1 year ago

      One way my code improves is by thinking what I need to comment. Then I refactor some and the comments become somewhat redundant.

      • ChickenLadyLovesLife@lemmy.world
        link
        fedilink
        English
        arrow-up
        2
        ·
        1 year ago

        I was basically driven out of my last job by someone who wouldn’t agree to work with someone (me) who did comment their code. Like I said, it’s a really weird dividing line in programming.

        • afraid_of_zombies@lemmy.world
          link
          fedilink
          arrow-up
          2
          ·
          1 year ago

          I am sorry that happened to you but it sounds like it was for the best. I work at a place where knowledge sharing is pushed for. Everyone shares what they know. It makes things so much easier even if we do “waste” time cross training.

          My last job was me replacing the inhouse developer, I got it by demonstrating on the interview that I could reverse engineer his code. The versions he had put into production had all the comments stripped out and he had replaced every variable with random alphanumeric sequences about 8 characters long.

          Shouldn’t have known right there and then what kinda workplace I was dealing with.