Comment by skydhash

Code is also design. It’s a blueprint for the process that is going to do the useful work we want. When something bad happens to the process, we revise its blueprint. And just like blueprint, the docs in natural language shows the why, not the how or the what. The blueprint is the perfect representation of the last two.