CurrentUnderstand · Guide

Public decisions and proposals

Choose an RFC, ADR, policy page, release note, or history record for the decision you need to propose or inspect.

Choose the record typeEstimated time5 minutes

Trust, applicability, and sourcesCurrent public project policy or service surface

AudienceContributors · Maintainers · Agents · Evaluators

Applies toCurrent public project policy or service surface

Last reviewed2026-07-04

Choose the right record

RFC: a substantial public proposal that still needs review, evidence, or a decision.
ADR: a durable architecture or product decision, including context, alternatives, consequences, and supersession.
History record: a replaced or withdrawn public statement retained so old links and discussions remain interpretable.
Task documentation: instructions and explanations derived from current authorities; it is not a substitute for a decision record.

A Draft or Review RFC is not shipped behavior.
An Accepted RFC authorizes implementation work but does not prove implementation or release.
An ADR records a decision; runtime behavior still requires implementation, tests, capability gates, and release evidence.
A superseded record remains readable and links to its replacement.
Security-sensitive details, credentials, private operations, customer data, forecasts, and unapproved commercial assumptions do not enter public records.