Skip to content

Latest commit

 

History

History
117 lines (72 loc) · 3.28 KB

implementation-decisions.md

File metadata and controls

117 lines (72 loc) · 3.28 KB

Concrete implementation decisions

This file is a repository to capture concrete decisions that have to be made in order to implement the specs found in this repo. The idea here is that we have a record of extra decisions which are outside of the scope of the formal spec.

When such a case is found a section should be added to this document outlining the decision made and the section of the spec or rule that the decision corresponds to. In a specific format:

Format

The format is similar to the Architectural Decision Record 1 used in issues in the wallet. This consists of:

Context

Decision

PR

Development Plan

Implications

Process

This file should be edited by adding a section matching the format above in a PR against this repo. The PR should reference and issues in the implementation repo.

After that there are a few options:

The decision is agreed to

The proposal becomes the choice for concrete implementations henceforth. The PR is approved and merged

The decision needs refinement

This refinement is discused in the PR proposing the decision, the section is ammended until we agree on the decision (this should be timeboxed) as we can always revisit any decisions.

Decisions

This is the section that should be appended to when decisions are made

This is where the title goes

Context

Decision

PR

Number Base
https://github.com/some/other-repo/issues/14 develop
#42 release/2.0.0

Development Plan

Implications

Footnotes

  1. https://adr.github.io/