
Design documents
Once there is an agreed concept of what changes would be required to solve a problem, a good engineering practice is to write a design document and solicit feedback from peers, users and stakeholders. Often companies have internal templates on how to write good design documents. However, I have seen many engineers miss stating key information in their documents. This post hopefully can provide an overview of what information is useful for reviewers....