An Architectural Decision Record (ADR) is a document that records an architectural decision. I heard of the concept about a decade ago, and I loved it! I have been a software developer long enough to know the pain of looking at a project and asking WHY THE HELL DID YOU DO IT THIS WAY?. And often it’s my own code. We do things for reasons. We make choices. Sometimes they are informed, sometimes they are made in the agile spirit of do the dumbest thing that works before we realise several years later that the entire project was subsequently built on the dumbest thing that worked and that, actually, investing a bit more time at the start could have saved millions of monetary units and increased the quality of peoples lives. Read more...