DEV Community

Discussion on: "Do not comment on your code, it should be self-documented". Well... I don't agree.

Collapse
 
garyfuhr profile image
garyfuhr

I think comments are valuable, but only if the comments come first. Outline what you plan to code first will give you focus to ensure a better outcome than the other way around.

I found when devs comment after, the comments tend to describe what the code does instead of what is the intent or the "big picture".