Skip to content

Bump specification stable to v0.9 and draft to v0.10#1419

Open
selamw1 wants to merge 1 commit into
mainfrom
stable_ver_bump
Open

Bump specification stable to v0.9 and draft to v0.10#1419
selamw1 wants to merge 1 commit into
mainfrom
stable_ver_bump

Conversation

@selamw1
Copy link
Copy Markdown
Collaborator

@selamw1 selamw1 commented May 12, 2026

Bumps the A2UI documentation and specification status to reflect version 0.9 as the latest stable release, version 0.10 as the active draft, and version 0.8 as legacy.

Proposed Changes

  • Specification Pages (docs/specification/):
    • Shifted v0.9 specifications and evolution guides to Stable status.
    • Shifted v0.8 pages and A2A extensions to Legacy status.
    • Created wrapper files for v0.10 as the new active Draft specifications.
  • Navigation Configuration (mkdocs.yaml): Re-ordered navigation hierarchy under the Specifications node to place v0.9 (Stable) at the top.
  • Site Documentation: Updated indices, roadmap, overview, quickstart, and what-is-a2ui example models to align references to v0.9 stable features.
  • GitHub Repository Landing (README.md): Updated version warning notice in root landing page to v0.9.

Ref/Closes: #1374

Pre-launch Checklist

  • I signed the [CLA].
  • I read the [Contributors Guide].
  • I read the [Style Guide].
  • I have added updates to the [CHANGELOG].
  • I updated/added relevant documentation.
  • My code changes (if any) have tests.
  • If my branch is on fork, I have verified that scripts/e2e_test.sh passes.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the A2UI documentation to promote version 0.9 to stable and introduce version 0.10 as a draft. The changes include new specification files, updated protocol examples, and a reorganization of the documentation navigation structure. Review feedback identified several technical inaccuracies in the documentation, specifically regarding incorrect version references in section headers, copy-paste errors in legacy protocol descriptions, and malformed or missing examples for version 0.8.

Comment thread docs/concepts/overview.md
Comment thread docs/concepts/overview.md Outdated
Comment thread docs/introduction/what-is-a2ui.md Outdated
Comment thread docs/quickstart.md
@selamw1 selamw1 force-pushed the stable_ver_bump branch 2 times, most recently from 0543c57 to 86f0f0f Compare May 12, 2026 22:15
Copy link
Copy Markdown
Collaborator

@ditman ditman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't reviewed the whole thing, but I think this is breaking the documentation by changing the header versions without moving the json messages around.

A simpler fix may be to just update the adjective next to the version numbers, so something like:

=== "v0.8 (Stable)"

Would get changed to:

=== "v0.8 (Legacy)

Then if we want to move the code blocks around, it should be easy.

Who'd be best to review this further, @zeroasterisk?

Comment thread docs/concepts/overview.md

- **`surfaceUpdate`**: Define or update UI components
- **`dataModelUpdate`**: Update application state
- **`beginRendering`**: Signal the client to render
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the diff being weird? Otherwise this is wrong, I think that the messages that were under 0.9 earlier should be here now, because these are 0.8 right?

> ```
>
> This will ensure that all JS and CSS assets are inlined into the `index.html` file on build, making it ready to be served by your MCP server as a single resource.
!!! tip "Using Vite to inline"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What caused this reformat? Is this the prettier plugin?

### Example

=== "v0.8 (Stable)"
=== "v0.9 (Stable)"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, I don't think that updating the version numbers of the headers here is the right thing to do, because now the jsonl underneath doesn't match the version of the protocol on the title.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Stable version bump (0.8 -> 0.9) needed in docs

2 participants