Reorganize the docs nav hierarchy

Author: dmontagu

mkdocs.yml

@@ -11,14 +11,20 @@ copyright: © Pydantic Services Inc. 2024 to present
 
 nav:
   - Introduction: index.md
-  - install.md
-  - help.md
-  - contributing.md
-  - troubleshooting.md
-  - changelog.md
-  - Documentation:
-      - agents.md
-      - Models:
+  - Getting Started:
+      - install.md
+      - help.md
+      - troubleshooting.md
+
+  - Pydantic AI:
+      - Core Concepts:
+          - agents.md
+          - dependencies.md
+          - tools.md
+          - output.md
+          - message-history.md
+          - direct.md
+      - Models & Providers:
           - models/index.md
           - models/openai.md
           - models/anthropic.md
@@ -28,46 +34,69 @@ nav:
           - models/groq.md
           - models/mistral.md
           - models/huggingface.md
-      - dependencies.md
-      - tools.md
-      - toolsets.md
-      - output.md
-      - message-history.md
-      - testing.md
-      - logfire.md
-      - multi-agent-applications.md
-      - graph.md
-      - evals.md
-      - input.md
-      - thinking.md
-      - direct.md
-      - builtin-tools.md
-      - common-tools.md
-      - retries.md
-      - temporal.md
+      - Tools & Toolsets:
+          - toolsets.md
+          - builtin-tools.md
+          - common-tools.md
+      - Advanced Features:
+          - input.md
+          - thinking.md
+          - retries.md
+          - temporal.md
       - MCP:
           - mcp/index.md
           - mcp/client.md
           - mcp/server.md
-          - mcp/run-python.md
-      - A2A: a2a.md
+      - Multi-Agent Patterns: multi-agent-applications.md
+      - Testing: testing.md
+      - Debugging & Monitoring with Pydantic Logfire: logfire.md
+
+  - Pydantic Graph:
+      - Overview: graph.md
+      - API Reference:
+          - api/pydantic_graph/graph.md
+          - api/pydantic_graph/nodes.md
+          - api/pydantic_graph/persistence.md
+          - api/pydantic_graph/mermaid.md
+          - api/pydantic_graph/exceptions.md
+
+  - Pydantic Evals:
+      - Overview: evals.md
+      - API Reference:
+          - api/pydantic_evals/dataset.md
+          - api/pydantic_evals/evaluators.md
+          - api/pydantic_evals/reporting.md
+          - api/pydantic_evals/otel.md
+          - api/pydantic_evals/generation.md
+
+  - Integrations:
       - AG-UI: ag-ui.md
-      - cli.md
+      - A2A: a2a.md
+      - clai (CLI): cli.md
+      - MCP Run Python: mcp/run-python.md
+
   - Examples:
-      - examples/index.md
-      - examples/ag-ui.md
-      - examples/pydantic-model.md
-      - examples/weather-agent.md
-      - examples/bank-support.md
-      - examples/sql-gen.md
-      - examples/flight-booking.md
-      - examples/rag.md
-      - examples/stream-markdown.md
-      - examples/stream-whales.md
-      - examples/chat-app.md
-      - examples/question-graph.md
-      - examples/slack-lead-qualifier.md
-      - examples/data-analyst.md
+      - Overview: examples/index.md
+      - Getting Started:
+          - examples/pydantic-model.md
+          - examples/weather-agent.md
+      - Conversational Agents:
+          - examples/chat-app.md
+          - examples/bank-support.md
+      - Data & Analytics:
+          - examples/sql-gen.md
+          - examples/data-analyst.md
+          - examples/rag.md
+      - Streaming:
+          - examples/stream-markdown.md
+          - examples/stream-whales.md
+      - Complex Workflows:
+          - examples/flight-booking.md
+          - examples/question-graph.md
+      - Business Applications:
+          - examples/slack-lead-qualifier.md
+      - UI Examples:
+          - examples/ag-ui.md
 
   - API Reference:
       - api/ag_ui.md
@@ -117,6 +146,10 @@ nav:
       - api/pydantic_evals/generation.md
       - api/fasta2a.md
 
+  - Project:
+      - contributing.md
+      - changelog.md
+
 extra:
   # hide the "Made with Material for MkDocs" message
   generator: false