Skip to content

docs: document v0.3 compatibility layer and standardize terminology#859

Open
kabir wants to merge 2 commits intoa2aproject:mainfrom
kabir:compat-doc
Open

docs: document v0.3 compatibility layer and standardize terminology#859
kabir wants to merge 2 commits intoa2aproject:mainfrom
kabir:compat-doc

Conversation

@kabir
Copy link
Copy Markdown
Collaborator

@kabir kabir commented May 8, 2026

  • Update architecture doc (compatibility_0.3.md) to reflect current state: multi-version deployment is implemented, remove historical planning artifacts, add VersionRouter and multi-version module docs
  • Add README sections for serving v0.3 clients (standalone and multi-version) and communicating with v0.3 agents using Client_v0_3
  • Standardize terminology from "dual-version" to "multi-version" across POM descriptions, @disabled annotations, and test names
  • Add AGENTS.md reference to compatibility architecture doc

Fixes #856

- Update architecture doc (compatibility_0.3.md) to reflect current
  state: multi-version deployment is implemented, remove historical
  planning artifacts, add VersionRouter and multi-version module docs
- Add README sections for serving v0.3 clients (standalone and
  multi-version) and communicating with v0.3 agents using Client_v0_3
- Standardize terminology from "dual-version" to "multi-version"
  across POM descriptions, @disabled annotations, and test names
- Add AGENTS.md reference to compatibility architecture doc

This fixes a2aproject#856

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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 completes the implementation of the A2A Protocol v0.3 backward compatibility layer, moving it from a deferred state to a fully supported feature. Key changes include the introduction of multi-version server deployment modules for JSON-RPC and REST, the VersionRouter for request dispatching based on the A2A-Version header, and comprehensive documentation updates in the README and architecture guides. Review feedback highlighted opportunities to improve the documentation examples by using more idiomatic transport configuration patterns and correcting redundant logic in the client discovery code snippets.

Comment thread README.md Outdated
Comment thread README.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feat]: Document the new compat-0.3 layer

1 participant