This is a template for EdgeX Foundry ADR.
Source: https://docs.edgexfoundry.org/2.3/design/adr/template/
List ADR submitters.
Format:
- Name (Organization)
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:
- [Status of ADR e.g. approved, amended, etc.](URL of pull request) YYYY-MM-DD
List all relevant use case / requirements documents.
ADR requires at least one relevant, approved use case.
Format:
- [Use Case Name](URL)
Add explanations if the ADR is not addressing all the requirements of a use case.
Describe:
-
how the design is architecturally significant - warranting an ADR (versus simple issue and PR to fix a problem)
-
the high level design approach (details described in the proposed design below)
Details of the design (without getting into implementation where possible).
Outline:
-
services/modules to be impacted (changed)
-
new services/modules to be added
-
model and DTO impact (changes/additions/removals)
-
API impact (changes/additions/removals)
-
general configuration impact (establishment of new sections, changes/additions/removals)
-
devops impact
Document alternatives, concerns, ancillary or related issues, questions that arose in debate of the ADR.
Indicate if/how they were resolved or mollified.
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:
- [ADR Title](URL) - Relevance
List additional references.
Format:
- [Title](URL)