• curbstickle@lemmy.dbzer0.com
      link
      fedilink
      arrow-up
      0
      ·
      edit-2
      3 days ago

      That really depends.

      Especially for a function that may see use in a variety of scenarios.

      I’m going to be firmly against anyone suggesting against proper comments - which, I’m sorry, but you are by your own statement.

      Code will change for many, many, many reasons beyond just refactoring.

      Edit: and why it was refactored is important as well.

      There are just so many reasons, and yes, I will continue to be against this newer trend of “dont comment, make codes your comments”.

      All that is, is a great way to make your code harder to manage later. It doesnt take much effort to explain why you’re doing something.

      • pcouy@lemmy.pierre-couy.frOP
        link
        fedilink
        arrow-up
        0
        ·
        3 days ago

        Let’s rephrase my opinion, so that we can (hopefully) agree on something : What I’m arguing against is the “ChatGPT-style” (or “tutorial-style”) comments that I’ve seen all over juniors’ code, even before LLMs got widespread