diff --git a/contributing/ADRs/back-end/api-audience-tiering.md b/contributing/ADRs/back-end/api-audience-tiering.md index e65f3e9fff..3af0b6defe 100644 --- a/contributing/ADRs/back-end/api-audience-tiering.md +++ b/contributing/ADRs/back-end/api-audience-tiering.md @@ -52,9 +52,14 @@ This ADR complements the stability lifecycle. Stability still answers **"how mat - **Allowed moves**: `internal` → `unleash-ui`/`integration`/`sdk`/`public`. Moves away from `public`/`sdk` require explicit review due to customer impact. - **Not allowed**: Silent demotions of `public`/`sdk` without deprecation and communication. -## Downstream impact +## Downstream behavior + +- `public`: Highlighted in docs; default recommendation for customer integrations. +- `integration`: Visible in docs with an integration-specific note; caution about use outside stated clients. +- `sdk`: Highlighted in SDK-related docs; strong compatibility messaging. +- `unleash-ui`: Visible with a warning badge; discouraged for external integrations. +- `internal`: Hidden from public docs by default (can be shown in dev). -Mostly affects docs and how we present and organize our APIs. ## Consequences ### Positive