Architecture Decision

...

Document Properties Marker

override	false

Short Description	Document a architecture decision for an option. This is useful to state the reasons and the options that have been evaluated. Later other team members will have it easier to understand the decision.
Doctype	doctype	hide
Name	Architecture Decision
ID	`architecture-decision`
Suite	Software Development
Set	Software Development

hide

Parent

Parent Property

parent-doctype	topic
property-name	Name

Audience

Name List

doctype	role
render-no-hits-as-blank	true
property	Audience

Documentation Type

Name List

doctype	doctype-type
render-no-hits-as-blank	true
names	Q2 - Project
property	Documentation Type

Tags

Tag List

names	Software Development

Iteration

value

filled

focused

hide

Sort Key

hide

Section

index	true
title	Description

Document an architecture decision for an option. This is useful to state the reasons and the options that have been evaluated. Later other team members will have it easier to understand your decision.

...

Section

title	Properties

Transclusion

document	Note Box referencing common Document Properties
ids	Box

Section

title	Type

Types allow to group decisions. A project demands its own definition of types via the decision type document type.

Section

title	Sections

Section

title	Summary

Transclusion

document	Summary
ids	Designation

Section

title	Problem

Defines

Define the problem

for which a decision has been made by the team.

that this decision solves.

The problem has

these subsections:

the following subsections.

Section

title	Details

Defines

Define the problem that this decision solves.

Section

title	Relevance

Details

Describe why this decision is relevant for the project and why it should be documented to be referable to later.

Section

title	Implication

Details

Describe what general implications

this decision has

the fact that a decision is to be made, will have on the project.

Section

title	Problem Constraints

Documents

Define constraints

on the problem that influence the decision.

imposed on possible decisions.

These constraints are described in the following subsections

:

.

Section

title	Requirements

Illustrates

Illustrate the functional and non-functional-requirements that constrain the decision.

Section

title	Drivers

Details

Describe what other drivers are relevant for the decision.

Section

title	Risks

Details

Describe which risks are involved

for the

with this decision.

Section

title	Assumptions

Decisions have to be made in situations where not every information detail is available. Otherwise the path to take would be clear without any doubts. To close the gaps between known and unknown assumptions have to be made. This section allows to document the assumption so that the decision is better understandable later.

Section

title	Description

Details

Describe which assumptions

have been

you haven made to make the decision. It is assumed that assumptions cannot be proven, else this would be a requirement

or not mentioned if proven invalid

.

Section

title	Check Assumptions

Describe strategies how the given assumptions can be proofed or refuted?

Section

title	Risks

Which

List the risks

are assumed

this assumption has.

Section

title	Alternatives

A list of alternatives that have or have not been examined.

Decision

Provides information about the decision that has been made.

Statement

The decision statement

Define possible alternatives you have discussed.

Section

title	Decision

Provide information about why this option has been selected, who was involved in the decision and what consequences arise.

Section

title	Statement

Give a brief statement that defines what has been decided to do.

This should be a brief statement since this is also rendered in the index document.

Section

title	Reason

States

Document what reasons led to the decision.

Section

title	Implication

Details

Describe what implications this decision has on the project.

Section

title	Date

The

Log the date of the decision.

Decider

The list of stakeholders that made

Section

title	Deciders

List names of the stakeholders, who took part in the decision.

If there is uncertainty about why this decision has been made, these stakeholders may provide additional information. Consider then to include this information in this document.

Section

level	2
title	Subordinate Decisions

Complex decisions may be divided into its parts.

Transclusion

document	Document Sections
ids	standard-sections-bottom

...

Section

title	Resources

For a more detailed introduction to architecure decisions, please refer to Stefan Zörner's book
Cite
template $[Name]
document PDAC:Zörner2012
, chapter 3.

Piwik Set Multiple Custom Variables

Name	Value
Department	projectdoc
Category	projectdoc-doctype
Type	swdev-design

Space shortcuts

Page tree

Docs

Support

Free Blueprints

Tooling for Blueprints

Free Extensions

Spaces

Plugins for Maven

Incubator

Libraries for Java

Incubator

Add-ons for Confluence

Tools

Support

Team

Legal

Versions Compared

Old Version 1

New Version Current

Key

Decision

Statement

Decider

About

Keep up-to-date!

Powered by