https://emsenn.net/tags/knowledgegovernance/ Recent content in KnowledgeGovernance on emsenn.net Hugo en-us Mon, 09 Mar 2026 00:00:00 +0000 https://emsenn.net/library/domains/science/domains/information/domains/knowledge-systems/domains/adr/texts/specification/ Mon, 09 Mar 2026 00:00:00 +0000 https://emsenn.net/library/domains/science/domains/information/domains/knowledge-systems/domains/adr/texts/specification/ <h2 id="normative-scope">Normative scope</h2> <p>This specification IS normative about: ADR format and location. This specification IS NOT normative about: what decisions warrant an ADR (use judgment — if it would be confusing later without a record, write one).</p> <h2 id="required-fields-frontmatter">Required fields (frontmatter)</h2> <table> <thead> <tr> <th>Field</th> <th>Requirement</th> </tr> </thead> <tbody> <tr> <td><code>title</code></td> <td>MUST start with &ldquo;Decision:&rdquo;</td> </tr> <tr> <td><code>date-created</code></td> <td>MUST be ISO 8601</td> </tr> <tr> <td><code>authors</code></td> <td>MUST list decision-makers</td> </tr> <tr> <td><code>type</code></td> <td>MUST be <code>decision</code></td> </tr> <tr> <td><code>status</code></td> <td>MUST be one of: <code>accepted</code>, <code>superseded</code>, <code>proposed</code></td> </tr> </tbody> </table> <h2 id="required-sections-body">Required sections (body)</h2> <table> <thead> <tr> <th>Section</th> <th>Contains</th> </tr> </thead> <tbody> <tr> <td><code>## Context</code></td> <td>What situation prompted this decision</td> </tr> <tr> <td><code>## Decision</code></td> <td>What was decided, stated directly</td> </tr> <tr> <td><code>## Consequences</code></td> <td>What follows from this decision</td> </tr> <tr> <td><code>## Alternatives considered</code></td> <td>What was rejected and why</td> </tr> </tbody> </table> <h2 id="location">Location</h2> <p>ADRs MUST live in a <code>decisions/</code> directory within the Thing they govern. A decision about the knowing-semioverse standard goes in <code>knowing-semioverse/decisions/</code>. A decision about the ADR standard itself goes in <code>adr/decisions/</code>.</p>