Updates version descriptions in docs for 0.9 release#1377
Updates version descriptions in docs for 0.9 release#1377redbrogdon wants to merge 3 commits intogoogle:mainfrom
Conversation
redbrogdon
changed the title
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request promotes A2UI version 0.9 to 'Stable' and introduces version 0.10 as the 'Draft' release, while reclassifying version 0.8 as 'Legacy'. The changes involve updating version tables, roadmaps, and documentation examples to prioritize v0.9. However, the feedback highlights a critical issue: several links and navigation entries for the new v0.10 specification and evolution guide point to files that are missing from the PR, which will break the documentation build. There is also a recommendation to retain the v0.9 Evolution Guide link in the main index for better discoverability during the transition.
| - v0.10 (Draft): | ||
| - A2UI Protocol: specification/v0.10-a2ui.md | ||
| - Evolution Guide: specification/v0.10-evolution-guide.md |
There was a problem hiding this comment.
The navigation entries for v0.10 reference specification/v0.10-a2ui.md and specification/v0.10-evolution-guide.md, but these files are not present in the repository. This will cause the MkDocs build to fail as it cannot find the referenced files. Please ensure these files are added or remove the navigation entries until they are ready.
| | -------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | **[v0.8](specification/v0.8-a2ui.md)** | **Stable** | Current production release. Surfaces, components, data binding, adjacency list model. | | ||
| | **[v0.9](specification/v0.9-a2ui.md)** | **Draft** | Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. [Evolution guide →](specification/v0.9-evolution-guide.md) | | ||
| | **[v0.9](specification/v0.9-a2ui.md)** | **Stable** | Current production release. Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. | |
There was a problem hiding this comment.
The link to the Evolution Guide for v0.9 was removed from the version table. Since v0.9 is now the stable release, this guide remains highly relevant for users migrating from the legacy v0.8 version. It is recommended to keep this link in the table for better discoverability.
| | **[v0.8](specification/v0.8-a2ui.md)** | **Stable** | Current production release. Surfaces, components, data binding, adjacency list model. | | ||
| | **[v0.9](specification/v0.9-a2ui.md)** | **Draft** | Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. [Evolution guide →](specification/v0.9-evolution-guide.md) | | ||
| | **[v0.9](specification/v0.9-a2ui.md)** | **Stable** | Current production release. Adds `createSurface`, client-side functions, custom catalogs, and the extension specification. | | ||
| | **[v0.10](specification/v0.10-a2ui.md)** | **Draft** | Next version under development. | |
There was a problem hiding this comment.
This line references specification/v0.10-a2ui.md, which is missing from the pull request. This will result in a broken link on the landing page.
| For more information, see the following related documentation: | ||
|
|
||
| - [v0.8 Protocol Specification](v0.8-a2ui.md) (Stable). | ||
| - [v0.10 Protocol Specification](v0.10-a2ui.md) (Draft). |
There was a problem hiding this comment.
The link to the v0.10 Protocol Specification points to a non-existent file (v0.10-a2ui.md).
|
|
||
| - [v0.9 Protocol Specification](v0.9-a2ui.md) (Draft). | ||
| - [v0.9 Protocol Specification](v0.9-a2ui.md) (Stable). | ||
| - [v0.10 Protocol Specification](v0.10-a2ui.md) (Draft). |
There was a problem hiding this comment.
The link to the v0.10 Protocol Specification points to a non-existent file (v0.10-a2ui.md).
1 participant
This PR updates the docs to better reflect the status of current versions: