diff --git a/template/{% if sphinx %}docs{% endif %}/explanations/decisions.md b/template/{% if sphinx %}docs{% endif %}/explanations/decisions.md index f97c2f9f3..0533b98d4 100644 --- a/template/{% if sphinx %}docs{% endif %}/explanations/decisions.md +++ b/template/{% if sphinx %}docs{% endif %}/explanations/decisions.md @@ -1,14 +1,6 @@ -% This Source Code Form is subject to the terms of the Mozilla Public - -% License, v. 2.0. If a copy of the MPL was not distributed with this - -% file, You can obtain one at http://mozilla.org/MPL/2.0/. - # Architectural Decision Records -We record major architectural decisions in Architecture Decision Records (ADRs), -as [described by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions). -Below is the list of our current ADRs. +Architectural decisions are made throughout a project's lifetime. As a way of keeping track of these decisions, we record these decisions in Architecture Decision Records (ADRs) listed below. ```{toctree} :glob: true @@ -16,3 +8,5 @@ Below is the list of our current ADRs. decisions/* ``` + +For more information on ADRs see this [blog by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions). diff --git a/template/{% if sphinx %}docs{% endif %}/explanations/decisions/COPYME b/template/{% if sphinx %}docs{% endif %}/explanations/decisions/COPYME new file mode 100644 index 000000000..b466c7929 --- /dev/null +++ b/template/{% if sphinx %}docs{% endif %}/explanations/decisions/COPYME @@ -0,0 +1,19 @@ +# 3. Short descriptive title + +Date: Today's date + +## Status + +Accepted + +## Context + +Background to allow us to make the decision, to show how we arrived at our conclusions. + +## Decision + +What decision we made. + +## Consequences + +What we will do as a result of this decision.