Architecture Decision Records#
This section captures the significant architectural decisions for
saia-python as Architecture Decision Records (ADRs), written in the
MADR (Markdown ADR) format.
An ADR records a single decision: the context that forced it, the options considered, the option chosen, and the consequences. ADRs are append-only — if a decision is later revisited, a new ADR supersedes the old one (which is kept for history and marked as such). The CHANGELOG records what changed per release; ADRs record why a design is the way it is.
Index#
ADR |
Title |
Status |
|---|---|---|
Record architecture decisions |
Accepted |
|
|
Accepted |
|
Rate-limit metadata on responses |
Accepted |
|
|
Accepted |
|
Non-blocking operations via Futures and dedicated Sessions |
Accepted |
|
ARCANA reference parsing in the core (transport-agnostic) |
Accepted |
|
Transport-policy layer for rate-limit handling |
Accepted |
|
Native async transport ( |
Accepted |