Skip to content

Commit 9c3f2e5

Browse files
author
alan bount
committed
Docs: Move spec version status taxonomy to glossary
Adds a 'Project status terminology' section to docs/glossary.md containing the agreed specification version status taxonomy (draft / candidate / final / deprecated) from #1240. The roadmap now links to the glossary instead of carrying its own inline legend. Also reverts the React renderer row from 'Available' back to 'Stable' for consistency with the other maintained renderers; renderer status terminology will be discussed in a follow-up issue.
1 parent 08cc573 commit 9c3f2e5

2 files changed

Lines changed: 29 additions & 7 deletions

File tree

docs/glossary.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,3 +207,30 @@ Information, categorized as **not accessible by AI** (for example, credit card i
207207
Which information should not be accessible by AI is defined by owners of the application and it is **different in different contexts**. For example, in some contexts medical history should never go to AI, while in others AI is heavily used to help with medical diagnostics and thus needs medical history.
208208

209209
This term is important in the GenUI context, because end users want to **clearly see** what their input is allowed to go to the AI and what is not allowed.
210+
211+
## Project status terminology
212+
213+
Labels used in the [Roadmap](roadmap.md) and elsewhere to describe the maturity and support level of A2UI artifacts.
214+
215+
### Specification version status
216+
217+
Each version of the A2UI specification is labeled with one of the following statuses. This taxonomy was agreed in [#1240](https://github.com/google/A2UI/issues/1240).
218+
219+
- **draft**: not ready for use yet — under active development, may change significantly.
220+
- **candidate**: ready for experiments, but not finalized — being implemented in one or more SDKs as a proof of concept; small refinements are still expected.
221+
- **final**: active development is finished — will only be modified to correct ambiguities or errors. SDKs can and should implement it.
222+
- **deprecated**: a version that is not recommended for use.
223+
224+
Note that "latest" is intentionally not a status — the latest version is implied by the semver number. Multiple versions can simultaneously hold `final` status, and the ecosystem is expected to support more than one version at a time.
225+
226+
Current application:
227+
228+
| Version | Status |
229+
|---------|--------|
230+
| v0.8 | final |
231+
| v0.9 | final |
232+
| v0.10 | draft |
233+
234+
### Renderer status
235+
236+
Renderer status terminology is still being worked out (see [#1240](https://github.com/google/A2UI/issues/1240) for the parallel discussion on specs). For now the [Roadmap](roadmap.md) uses the informal labels **Stable**, **Planned**, and **Proposed**.

docs/roadmap.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,7 @@ This roadmap outlines the current state and future plans for the A2UI project. T
66

77
### Protocol
88

9-
Each specification version is labeled with one of the following statuses:
10-
11-
- **draft**: not ready for use yet
12-
- **candidate**: ready for experiments, but not finalized
13-
- **final**: active development is finished here
14-
- **deprecated**: a version that is not recommended for use
9+
Each specification version is labeled with one of the statuses defined in the [Specification Version Status](glossary.md#specification-version-status) section of the glossary (`draft`, `candidate`, `final`, `deprecated`).
1510

1611
| Version | Status | Notes |
1712
|---------|--------|-------|
@@ -27,7 +22,7 @@ Each specification version is labeled with one of the following statuses:
2722
| **Web Core Lib** | ✅ Stable | Web | Shared core lib for all web renderers |
2823
| **Web Components (Lit)** | ✅ Stable | Web | Framework-agnostic, works anywhere |
2924
| **Angular** | ✅ Stable | Web | Full Angular integration |
30-
| **React** |Available | Web | Official React renderer |
25+
| **React** |Stable | Web | Official React renderer |
3126
| **Flutter (GenUI SDK)** | ✅ Stable | Multi-platform | Works on mobile, web, desktop |
3227
| **Markdown (`@a2ui/markdown-it`)** | ✅ Stable | Web | Markdown rendering for Text widgets in all web renderers |
3328
| **Jetpack Compose** | 📋 Planned | Android | Planned for Q2 2026 |

0 commit comments

Comments
 (0)