docs(java): Update Java SDK documentation with improved navigation and version bump

- Update page titles to include Java prefix for clarity
- Remove breaking changes warnings for 0.8.x
- Add cross-navigation links between Java SDK pages
- Add quickstart demo references with tips
- Bump version from 0.9.0 to 0.10.0 in dependency examples
- Fix Tip block formatting in mcp-client.mdx
- Add content overview section to mcp-overview.mdx

Signed-off-by: Christian Tzolov <[email protected]>

Author: tzolov

docs/sdk/java/mcp-client.mdx

@@ -1,8 +1,10 @@
 ---
-title: MCP Client
+title: Java MCP Client
 description: Learn how to use the Model Context Protocol (MCP) client to interact with MCP servers
 ---
 
+Go to the [Java MCP Server](/sdk/java/mcp-server) to learn how to build MCP servers or the [Java MCP Overview](/sdk/java/mcp-overview) to understand the overall architecture.
+
 # Model Context Protocol Client
 
 The MCP Client is a key component in the Model Context Protocol (MCP) architecture, responsible for establishing and managing connections with MCP servers. It implements the client-side of the protocol, handling:
@@ -16,11 +18,13 @@ The MCP Client is a key component in the Model Context Protocol (MCP) architectu
 - Optional features like roots management and sampling support
 
 <Tip>
-
 The core `io.modelcontextprotocol.sdk:mcp` module provides STDIO and SSE client transport implementations without requiring external web frameworks.
 
 Spring-specific transport implementations are available as an **optional** dependency `io.modelcontextprotocol.sdk:mcp-spring-webflux` for [Spring Framework](https://docs.spring.io/spring-ai/reference/api/mcp/mcp-client-boot-starter-docs.html) users.
+</Tip>
 
+<Tip>
+This [quickstart demo](/quickstart/client), based on Spring AI MCP, you'll show you how to build an AI client that connects to MCP servers.
 </Tip>
 
 The client provides both synchronous and asynchronous APIs for flexibility in different application contexts.

docs/sdk/java/mcp-overview.mdx

@@ -1,19 +1,19 @@
 ---
-title: Overview
+title: Java SDK Overview
 description: Introduction to the Model Context Protocol (MCP) Java SDK
 ---
 
 Java SDK for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture)
 enables standardized integration between AI models and tools.
 
-<Note>
+## Content
 
-### Breaking Changes in 0.8.x ⚠️
-
-**Note:** Version 0.8.x introduces several breaking changes including a new session-based architecture.
-If you're upgrading from 0.7.0, please refer to the [Migration Guide](https://github.com/modelcontextprotocol/java-sdk/blob/main/migration-0.8.0.md) for detailed instructions.
-
-</Note>
+- [Introduction](/sdk/java/mcp-overview#features) - Overview of the Model Context Protocol (MCP) Java SDK
+  - [Features](/sdk/java/mcp-overview#features) - Overview of the features provided by the Java MCP SDK
+  - [Acrchitecture](/sdk/java/mcp-overview#architecture) - Overview of the Java MCP SDK architecture
+- [Java Dependencies](/sdk/java/mcp-overview#dependencies) - Java dependencies required to use the Model Context Protocol (MCP) SDK
+- [Java MCP Client](/sdk/java/mcp-client) - Learn how to use the Model Context Protocol (MCP) client to interact with MCP servers
+- [Java MCP Client](/sdk/java/mcp-client) - Learn how to implement and configure a Model Context Protocol (MCP) server
 
 ## Features
 
@@ -55,12 +55,12 @@ The SDK follows a layered architecture with clear separation of concerns:
   - StdioTransport (stdin/stdout) in the core module
   - HTTP SSE transports in dedicated transport modules (Java HttpClient, Spring WebFlux, Spring WebMVC)
 
-The MCP Client is a key component in the Model Context Protocol (MCP) architecture, responsible for establishing and managing connections with MCP servers.
+The [MCP Client](/sdk/java/mcp-client) is a key component in the Model Context Protocol (MCP) architecture, responsible for establishing and managing connections with MCP servers.
 It implements the client-side of the protocol.
 
 ![Java MCP Client Architecture](/images/java/java-mcp-client-architecture.jpg)
 
-The MCP Server is a foundational component in the Model Context Protocol (MCP) architecture that provides tools, resources, and capabilities to clients.
+The [MCP Server](/sdk/java/mcp-server) is a foundational component in the Model Context Protocol (MCP) architecture that provides tools, resources, and capabilities to clients.
 It implements the server-side of the protocol.
 
 ![Java MCP Server Architecture](/images/java/java-mcp-server-architecture.jpg)
@@ -154,7 +154,7 @@ Add the BOM to your project:
         <dependency>
             <groupId>io.modelcontextprotocol.sdk</groupId>
             <artifactId>mcp-bom</artifactId>
-            <version>0.9.0</version>
+            <version>0.10.0</version>
             <type>pom</type>
             <scope>import</scope>
         </dependency>
@@ -168,7 +168,7 @@ Add the BOM to your project:
 
 ```groovy
 dependencies {
-  implementation platform("io.modelcontextprotocol.sdk:mcp-bom:0.9.0")
+  implementation platform("io.modelcontextprotocol.sdk:mcp-bom:0.10.0")
   //...
 }
 ```

docs/sdk/java/mcp-server.mdx

@@ -1,16 +1,9 @@
 ---
-title: MCP Server
+title: Java MCP Server
 description: Learn how to implement and configure a Model Context Protocol (MCP) server
 ---
 
-<Note>
-
-### Breaking Changes in 0.8.x ⚠️
-
-**Note:** Version 0.8.x introduces several breaking changes including a new session-based architecture.
-If you're upgrading from 0.7.0, please refer to the [Migration Guide](https://github.com/modelcontextprotocol/java-sdk/blob/main/migration-0.8.0.md) for detailed instructions.
-
-</Note>
+Go to the [Java MCP Client](/sdk/java/mcp-client) to learn how to build MCP clients or [Java MCP Overview](/sdk/java/mcp-overview) for a general overview of the Model Context Protocol (MCP) in Java.
 
 ## Overview
 
@@ -32,6 +25,11 @@ Spring-specific transport implementations are available as an **optional** depen
 
 </Tip>
 
+<Tip>
+This [quickstart demo](/quickstart/server), based on Spring AI MCP, you'll show you how to build an MCP server.
+</Tip>
+
+
 The server supports both synchronous and asynchronous APIs, allowing for flexible integration in different application contexts.
 
 <Tabs>