Repository navigation
Document the modern client and restructure the docs - #1329
Merged
Merged
Conversation
Add a guide for the 2026-07-28 client (docs/client-modern.md) and bring the rest of the documentation in line with an SDK that has a classic and a modern client and server. - Navigation groups the guides into Classic and Modern. - Overview, index and quickstart are rewritten to cover both: a "Classic or Modern?" comparison, a feature table, and a first client call for each. - The classic architecture diagrams are redrawn as SVG, with matching modern ones added. - The modern client and server are no longer described as a preview. - CHANGELOG gains an entry for the modern client. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
Follow the terms of the MCP specification, which names the handshake-based revisions "legacy" and the per-request ones "modern". - Classic is renamed to Legacy in the navigation, the guides and the diagrams. Modern now comes first everywhere. - The SSE transport is labelled "Deprecated", as in the specification. - The modern client and server guides show each example in a Sync and an Async tab. - "Calling the Server" in the modern client guide explains the two steps of a call, in place of the "Spec" and "Terminal" columns. - Spring AI links point to the 2.1.0-SNAPSHOT reference. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
- Spring AI 2.1+ integrates the modern client and server; both modern guides gain a "Spring" section and drop it from "Not Yet Supported". - Legacy server guide: spec links point to the 2025-11-25 revision. - Documentation development page: project structure matches the folder. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
Kehrlann
approved these changes
Nov 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a guide for the 2026-07-28 client (docs/client-modern.md) and bring the rest of the documentation in line with an SDK that has a classic and a modern client and server.
Fixes #1273