← Back to context

Comment by acedTrex

1 day ago

I was investigating an ansible playbook yesterday that had a 45 line comment to explain a single apt install command, completely and utterly useless. I am updating my neovim to just collapse all comments, the noise is unbearable.

6 comments

acedTrex

Reply
sevenseacat  1 day ago

I've seen people report cleaner code by forbidding agents from writing comments. Anecdotal, but interesting.

  • cpeterso  20 hours ago

    Mozilla's Firefox AGENTS.md begins with:

      Limit the amount of comments you put in the code to a strict minimum. You should almost never add comments, except sometimes on non-trivial code, function definitions if the arguments aren't self-explanatory, and class definitions and their members.

  Do not remove existing comments unless they are directly related to what you are changing.

    https://searchfox.org/firefox-main/source/AGENTS.md

    • lelanthran  16 hours ago

      Is anybody else concerned that we've gone from exactly specifying to a computer, using an exact language, what to do, to a more sophisticated form of prayer?

      1 reply →

    • astrange  18 hours ago

      Something like this seems unlikely to work for a behavior so burned into them. It'd be better to do a second pass to delete all the nonsense comments.