YYYY-MM-DD:

Status: accepted | superseded by | revisited Area: signaling | keying | media | transport | codec Module(s): the implementation module(s) this concerns (e.g. mlow/toc).

Context

What was being implemented and what question forced a decision. Link the relevant spec page (the RFC-level description) and the implementation site.

Options considered

The choices that were genuinely on the table, each with its trade-off. Include the one not taken: the record is more useful for showing what was rejected and why.

Decision

The choice made, stated precisely (constants, byte order, formula, behavior).

Why

The reasoning. If it resolves a discrepancy between sources, say which sources and how it was settled (a capture, a vector, a reference reading). If it is provisional pending evidence, say what evidence would revisit it.

Consequences

What this commits us to, what it rules out, and anything downstream that must stay consistent with it. If it should feed back into the spec, note that.

References

• Spec: docs/<area>/<page>.md
• Implementation: <repo> <module> @ <commit>
• Evidence: vector / capture / reference source, as applicable.