nats-server/doc

Architecture Decision Records

The directory adr hold Architecture Decision Records that document major decisions made in the design of the NATS Server.

A good intro to ADRs can be found in Documenting Architecture Decisions by Michael Nygard.

When to write an ADR

Not every little decision needs an ADR, and we are not overly prescriptive about the format. The kind of change that should have an ADR are ones likely to impact many client libraries or those where we specifically wish to solicit wider community input.

Format

The adr-tools utility ships with a template that's a good starting point. We do not have a fixed format at present.

ADR Statuses

Each ADR has a status, let's try to use Proposed, Approved Partially Implemented, Implemented and Rejected.