Skip to content

Docs: Rename Standard Catalog to Basic Catalog and update v0.9 status#1302

Merged
zeroasterisk merged 4 commits into
mainfrom
docs-roadmap-after-v09
May 8, 2026
Merged

Docs: Rename Standard Catalog to Basic Catalog and update v0.9 status#1302
zeroasterisk merged 4 commits into
mainfrom
docs-roadmap-after-v09

Conversation

@zeroasterisk
Copy link
Copy Markdown
Collaborator

Rename 'Standard Catalog' and related terms to 'Basic Catalog' across the documentation files to align with the v0.9 specifications. Update v0.9 status from 'Draft' to 'Current' in index and introduction files. Update React renderer status for v0.9 to 'Stable' in renderers reference.

TAG=agy
CONV=97210f91-e190-45b1-ac9b-32bb0e86d314

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 documentation to reflect A2UI v0.9's transition from draft to current status, renames the 'standard catalog' to the 'basic catalog' across several files, and updates the project roadmap. The review feedback identifies a date discrepancy in the roadmap, structural issues resulting from changing headers to bold text, the removal of community-focused sections, and potential naming inconsistencies between the text and the underlying catalog files.

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md
Comment thread docs/reference/messages.md
Comment thread docs/roadmap.md Outdated
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.

This LGTM, but I have some comments on the role of the basic catalog and how we're using "stable" instead of "available" for some of our packages!

Comment thread docs/concepts/catalogs.md Outdated
Comment thread docs/concepts/components.md
Comment thread docs/ecosystem/renderers.md
Comment thread docs/guides/renderer-development.md
Comment thread docs/guides/renderer-development.md
Comment thread docs/reference/messages.md
Comment thread docs/reference/renderers.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/concepts/components.md
Comment thread docs/roadmap.md Outdated
@zeroasterisk
Copy link
Copy Markdown
Collaborator Author

Did a critical self-review pass and found that v0.9 status was inconsistent across the docs — roadmap.md and glossary.md correctly say Final, but several other pages still said "Draft" or "Current". Most concerning: docs/specification/v0.9-a2ui.md itself opened with v0.9 — Draft, which directly contradicts the rest of the PR.

7851a91 fixes this:

v0.8 labels are intentionally left as "Stable" everywhere to minimize churn — that can be a follow-up cleanup. "Standard catalog" remains in v0.8-specific contexts (the file is literally standard_catalog_definition.json).

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/glossary.md Outdated
Comment thread docs/index.md Outdated
Comment thread docs/roadmap.md Outdated
@polina-c
Copy link
Copy Markdown
Member

polina-c commented May 2, 2026

Added comments. Would you mind to also add list of labels from discussion to a section in CONTRIBUTING.md, or somewhere else, so that future maintainers have it for reference? It can be other PR.

@polina-c
Copy link
Copy Markdown
Member

polina-c commented May 5, 2026

LGTM with some comments. Address whatever you think is critical. Thank you for organizing docs.

@ditman
Copy link
Copy Markdown
Collaborator

ditman commented May 6, 2026

This got caught in the Great Repo Formatting of 2026, it'll need some rebasing (but the rebase should be easy, just accept your changes and re-apply the fix_format.sh script).

Rename 'Standard Catalog' and related terms to 'Basic Catalog' across the documentation files to align with the v0.9 specifications. Update v0.9 status from 'Draft' to 'Current' in index and introduction files. Update React renderer status for v0.9 to 'Stable' in renderers reference.

TAG=agy

CONV=97210f91-e190-45b1-ac9b-32bb0e86d314
…down-it

Restore level 3 headings in roadmap.md as requested by reviewer. Add @a2ui/markdown-it to ecosystem renderers doc.

TAG=agy

CONV=97210f91-e190-45b1-ac9b-32bb0e86d314
@zeroasterisk zeroasterisk force-pushed the docs-roadmap-after-v09 branch from 3992f2e to e542a5b Compare May 8, 2026 19:57
@zeroasterisk zeroasterisk merged commit 184b765 into main May 8, 2026
17 of 18 checks passed
@zeroasterisk zeroasterisk deleted the docs-roadmap-after-v09 branch May 8, 2026 20:40
@github-project-automation github-project-automation Bot moved this from Todo to Done in A2UI May 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants