• zalgotext@sh.itjust.works
      link
      fedilink
      arrow-up
      0
      ·
      4 hours ago

      Try handing over your “self documenting code” to a junior dev who doesn’t know the language it’s written in and see how far they get with it.

      Now hand that exact same codebase with comments to the same junior dev, and I guarantee you they’ll get further than without the comments.

      • Maalus@lemmy.world
        link
        fedilink
        arrow-up
        0
        ·
        4 hours ago

        I have given well documented code to plenty of juniors, it comes with being a senior dev / techlead. And it was perfectly understood. Maybe you simply don’t write self documenting code.

      • Maalus@lemmy.world
        link
        fedilink
        arrow-up
        0
        ·
        4 hours ago

        Not really an opinion when most companies run on self documenting code since time immemorial.