refactor: update documentation links for clarity and consistency; enhance descriptions for advanced usage and MCP servers

Author: brunoborges

src/site/markdown/documentation.md

@@ -12,8 +12,6 @@ This guide covers common use cases for the Copilot SDK for Java. For complete AP
 - [Choosing a Model](#Choosing_a_Model)
 - [Session Management](#Session_Management)
 
-📖 **[Advanced Usage →](advanced.html)** - Tools, BYOK, MCP Servers, Infinite Sessions, and more.
-
 ---
 
 ## Basic Usage
@@ -189,4 +187,4 @@ client.deleteSession(sessionId).get();
 
 - 📖 **[Advanced Usage](advanced.html)** - Tools, BYOK, MCP Servers, System Messages, Infinite Sessions
 - 📖 **[MCP Servers](mcp.html)** - Integrate external tools via Model Context Protocol
-- 📖 **[Javadoc](apidocs/index.html)** - Complete API reference
+- 📖 **[API Javadoc](apidocs/index.html)** - Complete API reference

src/site/markdown/index.md

@@ -68,8 +68,9 @@ public class Example {
 
 | Document | Description |
 |----------|-------------|
-| [API Reference & Advanced Usage](documentation.html) | Complete API documentation, event types, streaming, tools, and advanced features |
-| [MCP Servers Integration](mcp.html) | Guide to integrating Model Context Protocol servers |
+| [Documentation](documentation.html) | Basic usage, streaming, handling responses, and session management |
+| [Advanced Usage](advanced.html) | Tools, BYOK, MCP servers, infinite sessions, and more |
+| [MCP Servers](mcp.html) | Integrating Model Context Protocol servers |
 | [Javadoc](apidocs/index.html) | Generated API documentation |
 
 ## Try it with JBang