Why from a user level belongs in executable specifications.
Why from an implementation level belongs in comments, but that should be fairly rare. Most code shouldn't provoke the question "why on earth did they implement it like this?"
Why from an implementation level belongs in comments, but that should be fairly rare. Most code shouldn't provoke the question "why on earth did they implement it like this?"
That is to say, sure most code is obvious. I don't work on most code. I work on the parts that need fixing.