Re:Writing system software: code comments
by crdoconnor on Sunday October 07, 2018 @10:32AM
(#18160713)
>Code is the what. Comments are the why.
In general I'd prefer to see 'why' attached to behavioral tests.
When I am asking "why was it written this way?" 8 times out of 10 it's the actual desired behavior that I don't get, maybe 2 time out of 10 it's "why was it implemented this way" (and most of the time those are apologizing for hacks).
In general I'd prefer to see 'why' attached to behavioral tests.
When I am asking "why was it written this way?" 8 times out of 10 it's the actual desired behavior that I don't get, maybe 2 time out of 10 it's "why was it implemented this way" (and most of the time those are apologizing for hacks).