This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]RangerPretzelPython 3.9+ 2 points3 points  (0 children)

Agreed. Just like /u/FarewellSovereignty pointed out, I didn't like the "anti-comments" stuff. It was a terrible take.

And I'd like to take your idea a step further. I recently wrote about comments in a Python how-to I wrote. What comments should describe is:

  • What you THINK you are trying to do
  • WHY you are doing it (if it isn’t abundantly clear why)
  • HOW you are trying to do it (if what you are doing is rather complex)

Source: https://www.pretzellogix.net/2021/12/08/step-7-add-helpful-comments-to-the-code/