Discussion on: My take on commenting code - Explain why, not how

[gudata]

Here is one more usage of the comments in order this article to be complete.

When I want to write something with multiple steps I like to draft them as

# Do first
# for each item
# do something else
# Do final thing

So then I implement the logic bellow the comments

first()
for each item in items:
  something_else()
final()

[Keff]

Fantastic addition, I also do this, it's a simple way to map out your ideas. I either do it with comments or using a markdown file, I prefer using markdown as I can then keep a log of what my thought process was at the time!