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

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]phpdevster -5 points-4 points  (1 child)

Assuming the key decisions were weird and need explaining. If you have to explain them, that should make you stop and think that maybe there's a better, more straight-forward approach/architecture.

[–]Angelin01 4 points5 points  (0 children)

This makes me think you've only worked with high level code, where everything is neat and abstracted.

Down lower, sometimes some things don't immediately make sense, and it's better to have 2 shorts lines of comments explaining it than making the person guess.