Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
titleProperties
Transclusion
documentNote Box referencing common Document Properties
idsBox

Section
titleType

Types allow to group decisionsGroup decisions by their type. A project demands may provide its own definition set of types via the Decision Type Doctype.

Section
titleSponsors

List the decision type document type stakeholders that take special interest in this decision and therefore support the effort put into this.

Section
titleSections
Section
titleSummaryProblem

Give a short summary about what has been decided. Add anything that is of interest for users having a brief look at this document.

Section
titleProblem

Define Defines the problem for which a decision has been made by the team. The problem has these subsections:

Section
titleDetails

Defines Define the problem that this decision solves.

Section
titleRelevance

Details Provide details why this is relevant for the project and why it should be documented to be referable later.

Section
titleImplication

Details Provide details what implications this decision has on the project.

Section
titleProblem Constraints

Documents Document constraints on the problem that influence the decision. These constraints are described in the following subsections:

Section
titleRequirements

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

Section
titleDrivers

Details Provide details what other drivers are relevant for the decision.

Section
titleRisks

Details Provide details which risks are involved for the decision.


Section
titleAssumptions

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
titleDescription

Details Provide details which assumptions have been 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
titleCheck Assumptions

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

Section
titleRisks

Which risks are assumed List the risks you assume this assumption has.


Section
titleAlternatives

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

Section
titleDecision

Provides Provide information about the decision that has been made.

Section
titleStatement

The decision statement defines Define what has been decided to do. This should be a brief statement since this is also rendered in the index document.

Section
titleReason

States State what reasons led to the decision.

Section
titleImplication

Details Provide details what implications this decision has on the project.

Section
titleDate

The Specify the date of the decision.

Section
titleDeciderDeciders

The Provide a list of stakeholders that made the decision. If there is uncertainty about why this decision has been made, these stakeholders may provide additional information at a later time. Consider then to include this information in this document.


Transclusion
documentDocument Sections
idsstandard-sections-bottom

 

...

Section
indextrue
titleRelated Doctypes
Section
titleDecision Type

Allows The Decision Type Doctype to categorize specifically on decisions.

Example Box

The type '

architecture

marketing' may tag decisions to be relevant for the

architecture

marketing of the

system

product.

Section
titleAlternative

Alternatives may be documented with the Alternative Doctype in greater detail if it is relevant to have the research results available for later reference.

Section
titleArchitecture Decision

The Software Development Doctypes Add-on has a doctype to document decisions for the architecture (Architecture Decision Doctype) of a software system.

Section
indextrue
titleSub-Doctypes
Display Table
doctypedoctype
render-no-hits-as-blanktrue
selectName, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name

...