• cbazero@programming.dev
      link
      fedilink
      arrow-up
      15
      arrow-down
      2
      ·
      9 hours ago

      You dont. Thats why you write code that explains itself. For higher level info you write documentation.

        • Maalus@lemmy.world
          link
          fedilink
          arrow-up
          3
          arrow-down
          1
          ·
          40 minutes ago

          The only moment you write comments is when you are doing something extremely weird for a specific reason that will not be immediately obvious and you want to warn the person doing a refactor in the future. In any other case, writing self documenting code is the way. If you are unable to do that, then your code needs to be rewrtitten.