engineering

Software projects consistently remain over budget, late and most importantly, many times miss solving the very problem they set out to solve in the first place. A recent and poignant memory was the rollout of the Obamacare health insurance exchanges. Why does this happen? As technology has improved and become more human centric (good), architectures to solve these problems have become more complex. For example, kubernetes is the latest and hottest virtualization technology promising efficient and reliable compute resources in cloud computing....

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....