Architecture Decision Records

We all know that architects need to make decisions. These decisions have lasting impacts, and can be in various states, such as new, in force, obsolete, etc. How do you record these decisions, and keep those records up to date?

I recently read through this blog post: http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions which describes what looks to me to be a very good way to document these records. Has anybody else tried that method, or something similar?

Has anybody tried something else?

We briefly tried to use a Confluence wiki page to keep track of these, but it quickly fell out of use and became outdated.

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.