• zalgotext@sh.itjust.works
    link
    fedilink
    arrow-up
    2
    arrow-down
    1
    ·
    14 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
      2
      arrow-down
      3
      ·
      13 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.