Architectural Decision Record ADR

Architecture Decision Record ADR is a compact and traceable documentation of all important decisions taken during the realization of a product. Use asciidoc or markdown and Git to have an agile and lean documentation of your major decisions.

The huge advantage of ADR is the timeline of the decisions. It tremendously help to understand the technical changes during the product lifecycle.