architecture-decision-record

Architecture Decision Record (ADR) template

This is a template for EdgeX Foundry ADR.

Source: https://docs.edgexfoundry.org/2.3/design/adr/template/

Submitters

List ADR submitters.

Format:

Change Log

List the changes to the document, incl. state, date, and PR URL.

State is one of: pending, approved, amended, deprecated.

Date is an ISO 8601 (YYYY-MM-DD) string.

PR is the pull request that submitted the change, including information such as the diff, contributors, and reviewers.

Format:

Referenced Use Case(s)

List all relevant use case / requirements documents.

ADR requires at least one relevant, approved use case.

Format:

Add explanations if the ADR is not addressing all the requirements of a use case.

Context

Describe:

Proposed Design

Details of the design (without getting into implementation where possible).

Outline:

Considerations

Document alternatives, concerns, ancillary or related issues, questions that arose in debate of the ADR.

Indicate if/how they were resolved or mollified.

Decision

Document any agreed upon important implementation detail, caveats, future considerations, remaining or deferred design issues.

Document any part of the requirements not satisfied by the proposed design.

List any relevant ADRs - such as a design decision for a sub-component of a feature, a design deprecated as a result of this design, etc..

Format:

References

List additional references.

Format: