github.com/gemaraproj/gemara@v0.23.0

docs/adrs/0011-definition-measurement.md raw

 1---
 2layout: page
 3title: Adjust "Upper" and "Lower" Layer Descriptors into "Definition" and "Measurement"
 4---
 5
 6- **ADR:** 0011
 7- **Proposal Author(s):** @jpower432
 8- **Status:** Accepted
 9
10## Context
11
12Our documentation occasionally refers to layers 1, 2, and 3 as "lower layers" with layers 5, 6, and 7 as "upper layers." This has not proven to be universally understood, and when images provide a cascading view (with 1 at the top) the terminology becomes actively unhelpful.
13
14## Decision
15
16We will describe layers 1-3 as "Definition" and layers 5-7 as "Measurement"
17
18## Consequences
19
20- All documentation and web content must be updated
21
22## Alternatives Considered
23
24Several alternative terms were debated on a live working session and quickly disregarded.