Comment "The reason why" lost in final work product (Score 2) 75
Look at most instruction manuals. Look at most architectural blueprints. Look at a schematic. Look at a recipe book. Look at most other "work products" that amount to human-readable instruction manuals.
Now look for the "why". "Why are we doing this in the first place." "Why did we do it this way vs. the various alternatives." Etc.
Sometimes you will see the "why" but most of the time you won't.
At least code has the advantage of having a mechanism to put the documentation near the relevant portion of the final work product.