Skip to content

docs: reorganize files to match nav sections, add ADK + comparison updates#776

Merged
zeroasterisk merged 17 commits intogoogle:mainfrom
zeroasterisk:feat/docs-file-org
Mar 11, 2026
Merged

docs: reorganize files to match nav sections, add ADK + comparison updates#776
zeroasterisk merged 17 commits intogoogle:mainfrom
zeroasterisk:feat/docs-file-org

Conversation

@zeroasterisk
Copy link
Collaborator

@zeroasterisk zeroasterisk commented Mar 5, 2026

Summary

Reorganizes documentation files to match their navigation sections, updates content for React renderer launch, improves community contribution guidance, and adds the web_core shared library section to the renderer development guide.

File Moves

File From To
catalogs.md docs/ docs/concepts/
transports.md docs/ docs/concepts/
client_to_server_actions.md docs/ docs/concepts/
renderers.md docs/ docs/reference/
agents.md docs/ docs/reference/
community.md docs/ docs/ecosystem/
where-is-it-used.md docs/introduction/ docs/ecosystem/a2ui-in-the-world.md

All old URLs redirect via mkdocs-redirects plugin.

Content Updates

React renderer merged (#542)

  • Updated renderer status from "In Review" to ✅ Stable across all pages
  • Added React section to client-setup guide with install instructions
  • Added React to "How Can I Use It?" quick setup
  • Linked to React shell sample

Renderer development guide

  • New section: "Web Renderers: Use web_core" — explains the shared library that Lit, Angular, and React all build on, with import examples and version support table

Community & ecosystem

  • Expanded "Submitting a Renderer" with step-by-step contribution guide
  • Replaced "Coming soon..." placeholder with concrete guidance and sample links
  • Collapsed duplicate partner info (community.md now points to a2ui-in-the-world.md)
  • Added live shields.io badges (⭐ stars, last commit) to community renderers table
  • Fixed ChatKit link to actual docs page
  • Fixed typo: "signiciant" → "significant"

Comparison & positioning

  • Rewrote "How Does A2UI Compare?" as concise comparison with table
  • Added Google ADK section to "A2UI in the World"
  • Credited CopilotKit for Composer (not React renderer)

Links & tables

  • All renderer names in tables now link to source code
  • Fixed broken relative paths between ecosystem docs
  • Added redirects for all moved files

No structural nav changes

The nav section names and ordering are unchanged. Only file paths were updated to match.

@google-cla
Copy link

google-cla bot commented Mar 5, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Copy link
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 effectively reorganizes the documentation by moving files into new directories that align with the navigation structure. It also includes significant content updates, such as rewriting the "How Does A2UI Compare?" page and adding a new section for the Google Agent Development Kit (ADK). All file moves are accompanied by corresponding link updates and redirects in mkdocs.yaml to prevent broken links. My review identified a couple of links in the documentation that could be improved for accuracy and specificity. Overall, this is a great improvement to the documentation's structure and content.

Zaf added 10 commits March 10, 2026 21:57
- Move catalogs, transports, client_to_server_actions → concepts/
- Move renderers, agents → reference/
- Move where-is-it-used, community → ecosystem/
- Rewrite agent-ui-ecosystem as concise 'How Does A2UI Compare?' intro page
- Move third-party integrations (json-render, OpenClaw) to ecosystem
- Fix all cross-references for moved files
- Remove duplicate nav entries (each page appears once)
- native-first → declarative UI, clarify host controls styling
- MCP Apps: clarify remote controls content, config via tool calling
- AG UI: credit CopilotKit team, React renderer, Composer contributions
- ChatKit: note shared design philosophy (basic components, declarative)
ADK Web has native A2UI rendering and A2A↔A2UI message conversion.
Links to ADK docs, adk-web repo, and agent development guide.
React renderer PR google#542 is still open and not by CopilotKit.
Composer was contributed by maxkorp (@CopilotKit).
Old URLs now redirect to new locations:
- catalogs, transports, actions → concepts/
- renderers, agents → reference/
- community → ecosystem/
- where-is-it-used → ecosystem/a2ui-in-the-world
- React renderer PR google#542 merged — update status to Stable across all pages
- Add React section to client-setup guide
- Expand community renderer submission with step-by-step instructions
- Replace community showcase placeholder with concrete guidance + sample links
- Collapse duplicate partner info in community.md (points to a2ui-in-the-world)
- Fix typo (signiciant → significant)
- Tighten how-to-use wording, fix Angular install (add @a2ui/web-lib)
@zeroasterisk zeroasterisk merged commit fe74e8c into google:main Mar 11, 2026
8 of 9 checks passed
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.

1 participant