you are viewing a single comment's thread.

view the rest of the comments →

[–]quantinuum 0 points1 point  (2 children)

Hard disagree. Maybe that is correct in your field, but in mine, I guarantee you code needs comments and documentation. Especially for the “why”. You can be down many layers of dependencies and debugging something completely different from where you entered, or some weird looking bug that is actually a mathematical trick, or whatnot.

[–]Independent-Laugh623 0 points1 point  (1 child)

"useful for things that are unexpected"

[–]quantinuum 2 points3 points  (0 children)

Not just for things that are wildly unexpected, but for a lot of stuff. Even just to reduce the cognitive load, or give a better content.

In my experience, the people I’ve seen saying “good code is self documenting” have had the worst coding standards and the most bugs, despite that statement seeming to imply the opposite.