On: When code is a maze, smart developers make maps (2025)

[adrianN]

It's difficult to refactor and rearchitect without first understanding what's there and why.

[jorisw → adrianN]

And yourself putting in comments is the solution to that?

[adrianN → jorisw]

It depends on how much time you can spend on the task. If you're allowed to write proper documentation about architecture and requirements that is probably better. If you're just drive-by fixing the code, then good comments are a lot better than nothing.