upvote
It's kind of tricky though because if you want to have a good design, you should be able to do the implementation yourself. You see this with orgs that separate the design and implementation and what messes they create. Having an inability to evaluate the implementation will lead to a bad product.
reply
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.
reply