Creating a document-driven engineering culture

My article on Agile Principle #6 provides compelling points on why documents are the best way to communicate to and within a software development team. But how can we create and foster a document-driven communication culture in our engineering organizations? Define document expectations Engineers do not like ambiguity so give them clear direction. This means... Continue Reading →

Denmark’s Rooftop Solar Black Box

Denmark's energy infrastructure is controlled by a centralized authority known as Energinet. Energinet makes a lot of rules and regulations, and I recently ran into a problem with rooftop solar installation regulations. The below diagram from Energinet shows a recommended installation configuration for rooftop solar of size < 50kW peak: Energinet recommended configuration for self... Continue Reading →

Postmortem template for software engineering

If you just want the template then here you go! Otherwise, continue reading to learn more about postmortems. Why you should write postmortems The most important reason to write a postmortem is for your own understanding. The process of writing the postmortem will undoubtedly reveal areas where your understanding is not as deep as it... Continue Reading →

Design doc template for software engineering

If you just want the template then here you go! Otherwise, continue reading to learn more about design docs and templates. Why you should write design documents The most important reason to write a design doc is for your own understanding. The process of writing the design doc will undoubtedly reveal areas where your understanding... Continue Reading →

My Amazon story

This is a very different post than I usually write because it is for my benefit, not yours. I need closure on my Amazon experience and I hope by writing down what happened I can let it go and fully move on. The first eight months or so at Amazon were great. I was working... Continue Reading →

Don’t read “Domain Driven Design”

I read Domain Driven Design (referred to in the following as DDD) by Eric Evans so you don't have to! And you probably shouldn't read it regardless. DDD is a really ambitious book trying to establish a right way to develop software but it, unfortunately, falls short. I want software engineering books to improve my... Continue Reading →

Up ↑