feat: Add sections and groupings to sidebar navigation menu

docs/stylesheets/custom.css

@@ -57,6 +57,12 @@
   overflow: visible !important;
 }
 
+/* Style for the main navigation section titles */
+nav.md-nav--primary .md-nav__item--section > .md-nav__link {
+  color: #1565C0;
+  font-weight: bold;
+  font-size: 0.8rem;
+}
 /* Community Resources cards */
 
 .resource-grid {

mkdocs.yml

@@ -74,6 +74,7 @@ theme:
     - navigation.instant
     - navigation.instant.progress
     - navigation.path
+    - navigation.sections
     - navigation.top
     - navigation.tracking
     - toc.follow
@@ -125,122 +126,128 @@ plugins:
 
 # Navigation
 nav:
-  - Home: index.md
-  - Get started:
-    - get-started/index.md
-    - Python: get-started/python.md
-    - Java: get-started/java.md
-  - Build your agent:
-    - tutorials/index.md
-    - Multi-tool agent: get-started/quickstart.md
-    - Agent team: tutorials/agent-team.md
-    - Streaming agent:
-      - get-started/streaming/index.md
-      - Python: get-started/streaming/quickstart-streaming.md
-      - Java: get-started/streaming/quickstart-streaming-java.md
-    - Testing: get-started/testing.md
-    - Code samples: https://github.com/google/adk-samples
-    - Advanced setup: get-started/installation.md
-  - Technical overview: get-started/about.md
-  - Agents:
-    - agents/index.md
-    - LLM agents: agents/llm-agents.md
-    - Workflow agents:
-      - agents/workflow-agents/index.md
-      - Sequential agents: agents/workflow-agents/sequential-agents.md
-      - Loop agents: agents/workflow-agents/loop-agents.md
-      - Parallel agents: agents/workflow-agents/parallel-agents.md
-    - Custom agents: agents/custom-agents.md
-    - Multi-agent systems: agents/multi-agents.md
-    - Agent Config: agents/config.md
-    - Models & Authentication: agents/models.md
-  - Tools for Agents:
-    - tools/index.md
-    - Built-in tools: tools/built-in-tools.md
-    - Gemini API tools:
-      -  Computer use: tools/gemini-api/computer-use.md
-    - Google Cloud tools:
-      - Overview: tools/google-cloud-tools.md
-      - MCP Toolbox for Databases: tools/google-cloud/mcp-toolbox-for-databases.md
-      - Code Execution with Agent Engine: tools/google-cloud/code-exec-agent-engine.md
-    - Third-party tools:
-      - tools/third-party/index.md
-      - Exa: tools/third-party/exa.md
-      - Firecrawl: tools/third-party/firecrawl.md
-      - GitHub: tools/third-party/github.md
-      - Hugging Face: tools/third-party/hugging-face.md
-      - Agentic UI (AG-UI): tools/third-party/ag-ui.md
-  - Custom Tools:
-    - tools-custom/index.md
-    - Function tools:
-      - Overview: tools/function-tools.md
-      - Tool performance: tools/performance.md
-      - Action confirmations: tools/confirmation.md
-    - MCP tools: tools/mcp-tools.md
-    - OpenAPI tools: tools-custom/openapi-tools.md
-    - Authentication: tools/authentication.md
+  - Building Agents:
+    - Home:
+      - index.md
+    - Get started:
+      - get-started/index.md
+      - Python: get-started/python.md
+      - Java: get-started/java.md
+    - Build your agent:
+      - tutorials/index.md
+      - Multi-tool agent: get-started/quickstart.md
+      - Agent team: tutorials/agent-team.md
+      - Streaming agent:
+        - get-started/streaming/index.md
+        - Python: get-started/streaming/quickstart-streaming.md
+        - Java: get-started/streaming/quickstart-streaming-java.md
+      - Testing: get-started/testing.md
+      - Code samples: https://github.com/google/adk-samples
+      - Advanced setup: get-started/installation.md
+    - Agents:
+      - agents/index.md
+      - LLM agents: agents/llm-agents.md
+      - Workflow agents:
+        - agents/workflow-agents/index.md
+        - Sequential agents: agents/workflow-agents/sequential-agents.md
+        - Loop agents: agents/workflow-agents/loop-agents.md
+        - Parallel agents: agents/workflow-agents/parallel-agents.md
+      - Custom agents: agents/custom-agents.md
+      - Multi-agent systems: agents/multi-agents.md
+      - Agent Config: agents/config.md
+      - Models & Authentication: agents/models.md
+    - Tools for Agents:
+      - tools/index.md
+      - Built-in tools: tools/built-in-tools.md
+      - Gemini API tools:
+        -  Computer use: tools/gemini-api/computer-use.md
+      - Google Cloud tools:
+        - Overview: tools/google-cloud-tools.md
+        - MCP Toolbox for Databases: tools/google-cloud/mcp-toolbox-for-databases.md
+        - Code Execution with Agent Engine: tools/google-cloud/code-exec-agent-engine.md
+      - Third-party tools:
+        - tools/third-party/index.md
+        - Exa: tools/third-party/exa.md
+        - Firecrawl: tools/third-party/firecrawl.md
+        - GitHub: tools/third-party/github.md
+        - Hugging Face: tools/third-party/hugging-face.md
+        - Agentic UI (AG-UI): tutorials/ag-ui.md
+    - Custom Tools:
+      - tools-custom/index.md
+      - Function tools:
+        - Overview: tools/function-tools.md
+        - Tool performance: tools/performance.md
+        - Action confirmations: tools/confirmation.md
+      - MCP tools: tools/mcp-tools.md
+      - OpenAPI tools: tools/third-party/openapi-tools.md
+      - Authentication: tools/authentication.md
+    - Technical overview: get-started/about.md
   - Running Agents:
-    - Agent Runtime: runtime/index.md
-    - Runtime Config: runtime/runconfig.md
-    - Resume Agents: runtime/resume.md
-  - Deploy:
-    - deploy/index.md
-    - Agent Engine: deploy/agent-engine.md
-    - Cloud Run: deploy/cloud-run.md
-    - GKE: deploy/gke.md
-  - Sessions & Memory:
-    - sessions/index.md
-    - Session: sessions/session.md
-    - State: sessions/state.md
-    - Memory: sessions/memory.md
-    - Vertex AI Express Mode: sessions/express-mode.md
-  - Callbacks:
-    - callbacks/index.md
-    - Types of callbacks: callbacks/types-of-callbacks.md
-    - Callback patterns: callbacks/design-patterns-and-best-practices.md
-  - Artifacts:
-    - artifacts/index.md
-  - Events:
-    - events/index.md
-  - Context:
-    - context/index.md
-  - Observability:
-    - Logging: observability/logging.md
-    - Cloud Trace: observability/cloud-trace.md
-    - AgentOps: observability/agentops.md
-    - Arize AX: observability/arize-ax.md
-    - Phoenix: observability/phoenix.md
-    - W&B Weave: observability/weave.md
-  - Evaluate:
-    - evaluate/index.md
-    - Criteria: evaluate/criteria.md
-  - MCP:
-    - mcp/index.md
-  - Plugins:
-    - plugins/index.md
-  - Bidi-streaming (live):
-    - streaming/index.md
-    - Custom Audio Bidi-streaming app sample (WebSockets): streaming/custom-streaming-ws.md
-    - Bidi-streaming development guide series: streaming/dev-guide/part1.md
-    - Streaming Tools: streaming/streaming-tools.md
-    - Configurating Bidi-streaming behaviour: streaming/configuration.md
-    - Google ADK + Vertex AI Live API (blog post): https://medium.com/google-cloud/google-adk-vertex-ai-live-api-125238982d5e
-  - Grounding:
-    - Understanding Google Search Grounding: grounding/google_search_grounding.md
-    - Understanding Vertex AI Search Grounding: grounding/vertex_ai_search_grounding.md
-  - Safety and Security: safety/index.md
-  - A2A Protocol:
-    - a2a/index.md
-    - Introduction to A2A: a2a/intro.md
-    - A2A Quickstart (Exposing): a2a/quickstart-exposing.md
-    - A2A Quickstart (Consuming): a2a/quickstart-consuming.md
-    - A2A Protocol Documentation: https://a2a-protocol.org
-  - Community Resources: community.md
-  - Contributing Guide: contributing-guide.md
-  - API Reference:
-    - api-reference/index.md
-    - Python ADK: api-reference/python/index.html
-    - Java ADK: api-reference/java/index.html
-    - CLI Reference: api-reference/cli/index.html
-    - Agent Config reference: api-reference/agentconfig/index.html
-    - REST API: api-reference/rest/index.md
+    - Agent Runtime:
+      - Agent Runtime: runtime/index.md
+      - Runtime Config: runtime/runconfig.md
+      - Resume Agents: runtime/resume.md
+    - Deploy:
+      - deploy/index.md
+      - Agent Engine: deploy/agent-engine.md
+      - Cloud Run: deploy/cloud-run.md
+      - GKE: deploy/gke.md
+    - Observability:
+      - Logging: observability/logging.md
+      - Cloud Trace: observability/cloud-trace.md
+      - AgentOps: observability/agentops.md
+      - Arize AX: observability/arize-ax.md
+      - Phoenix: observability/phoenix.md
+      - W&B Weave: observability/weave.md
+    - Evaluate:
+      - evaluate/index.md
+      - Criteria: evaluate/criteria.md
+    - Safety and Security:
+      - safety/index.md
+  - Components:
+    - Sessions & Memory:
+      - sessions/index.md
+      - Session: sessions/session.md
+      - State: sessions/state.md
+      - Memory: sessions/memory.md
+      - Vertex AI Express Mode: sessions/express-mode.md
+    - Callbacks:
+      - callbacks/index.md
+      - Types of callbacks: callbacks/types-of-callbacks.md
+      - Callback patterns: callbacks/design-patterns-and-best-practices.md
+    - Artifacts:
+      - artifacts/index.md
+    - Events:
+      - events/index.md
+    - Context:
+      - context/index.md
+    - MCP:
+      - mcp/index.md
+    - Plugins:
+      - plugins/index.md
+    - Grounding:
+      - Understanding Google Search Grounding: grounding/google_search_grounding.md
+      - Understanding Vertex AI Search Grounding: grounding/vertex_ai_search_grounding.md
+    - Bidi-streaming (live):
+      - streaming/index.md
+      - Custom Audio Bidi-streaming app sample (WebSockets): streaming/custom-streaming-ws.md
+      - Bidi-streaming development guide series: streaming/dev-guide/part1.md
+      - Streaming Tools: streaming/streaming-tools.md
+      - Configurating Bidi-streaming behaviour: streaming/configuration.md
+      - Google ADK + Vertex AI Live API (blog post): https://medium.com/google-cloud/google-adk-vertex-ai-live-api-125238982d5e
+    - A2A Protocol:
+      - a2a/index.md
+      - Introduction to A2A: a2a/intro.md
+      - A2A Quickstart (Exposing): a2a/quickstart-exposing.md
+      - A2A Quickstart (Consuming): a2a/quickstart-consuming.md
+      - A2A Protocol Documentation: https://a2a-protocol.org
+  - Reference:
+    - API Reference:
+      - api-reference/index.md
+      - Python ADK: api-reference/python/index.html
+      - Java ADK: api-reference/java/index.html
+      - CLI Reference: api-reference/cli/index.html
+      - Agent Config reference: api-reference/agentconfig/index.html
+      - REST API: api-reference/rest/index.md
+    - Community Resources: community.md
+    - Contributing Guide: contributing-guide.md