Update documentation links for consistency and accuracy across various guides and lessons

Iamsdt · Iamsdt · commit 8e95854d378c · 2026-05-23T16:38:34.000+06:00
diff --git a/docs/beginner/call-from-typescript.md b/docs/beginner/call-from-typescript.md
@@ -167,6 +167,6 @@ You have completed the beginner path. Your agent can now:
 
 ## Next steps
 
-- **Core concepts** — understand how the pieces fit together at scale ([Concepts](/docs/concepts/architecture.md))
-- **Add a real checkpointer** — replace `InMemoryCheckpointer` with Postgres for production ([Checkpointing guide](/docs/how-to/production/checkpointing.md))
-- **Python library reference** — explore the full `StateGraph` and `Agent` API ([Reference](/docs/reference/python/agent.md))
+- **Core concepts** — understand how the pieces fit together at scale ([Concepts](/docs/concepts/architecture))
+- **Add a real checkpointer** — replace `InMemoryCheckpointer` with Postgres for production ([Checkpointing guide](/docs/how-to/production/checkpointing))
+- **Python library reference** — explore the full `StateGraph` and `Agent` API ([Reference](/docs/reference/python/agent))
diff --git a/docs/concept2/connecting-clients.md b/docs/concept2/connecting-clients.md
@@ -231,7 +231,7 @@ const ok = await client.ping();   // returns true if API is reachable
 
 | Guide | Link |
 |---|---|
-| Build a chat UI with React | [agentflow-ui docs](/packages/agentflow-ui) |
+| Build a chat UI with React | [React agent tutorial](/docs/tutorials/from-examples/react-agent) |
 | Server-side auth setup | [Serving Agents](./serving-agents.md) |
 | Register remote tools on the server | [Agents, Tools & Control](./agents-tools-control.md) |
-| Full client API reference | [API Reference](/api/client) |
+| Full client API reference | [API Reference](/docs/reference/client/agentflow-client) |
diff --git a/docs/concept2/memory.md b/docs/concept2/memory.md
@@ -258,7 +258,7 @@ flowchart TB
 
 | Guide | Link |
 |---|---|
-| Add per-thread checkpointing | [How-To: Checkpointing](/how-to/checkpointing) |
-| Add long-term memory to an agent | [How-To: Memory Store](/how-to/memory-store) |
+| Add per-thread checkpointing | [How-To: Checkpointing](/docs/how-to/production/checkpointing) |
+| Add long-term memory to an agent | [How-To: Memory Store](/docs/how-to/python/use-memory-store) |
 | Custom storage backends | [Extensibility](./extensibility.md) |
 | Thread management via API | [Serving Agents](./serving-agents.md) |
diff --git a/docs/concept2/qa.md b/docs/concept2/qa.md
@@ -396,7 +396,7 @@ Eval and testing tell you whether your agent is correct in controlled conditions
 
 | Guide | Link |
 |---|---|
-| Write your first eval | [How-To: Evaluation](/how-to/evaluation) |
+| Write your first eval | [How-To: Evaluation](/docs/how-to/api-cli/run-evals) |
 | Custom evaluation criteria | [Extensibility](./extensibility.md) |
 | Lifecycle hooks and callbacks | [Agents, Tools & Control](./agents-tools-control.md) |
 | Publisher backends | [Serving Agents](./serving-agents.md) |
diff --git a/docs/courses/COURSE_STYLE_GUIDE.md b/docs/courses/COURSE_STYLE_GUIDE.md
@@ -194,8 +194,8 @@ Continue to the next lesson to learn about [next topic].
 
 ### Or Explore
 
-- [Related concepts](/docs/courses/shared/glossary.md)
-- [Beginner course](/docs/courses/genai-beginner/index.md)
+- [Related concepts](/docs/courses/shared/glossary)
+- [Beginner course](/docs/courses/genai-beginner)
 ```
 
 ## Formatting Conventions
@@ -250,8 +250,8 @@ This is a warning.
 
 ```markdown
 - [Lesson 1](./lesson-1.md)
-- [Shared: Tokenization](/docs/courses/shared/tokenization-and-context-windows.md)
-- [AgentFlow Architecture](/docs/concepts/architecture.md)
+- [Shared: Tokenization](/docs/courses/shared/tokenization-and-context-windows)
+- [AgentFlow Architecture](/docs/concepts/architecture)
 ```
 
 ### External Links
diff --git a/docs/courses/genai-advanced/index.md b/docs/courses/genai-advanced/index.md
@@ -91,10 +91,10 @@ flowchart TB
 
 If you need a refresher:
 
-- [LLM basics](/docs/courses/shared/llm-basics-for-engineers.md)
-- [Tokenization](/docs/courses/shared/tokenization-and-context-windows.md)
-- [Embeddings](/docs/courses/shared/embeddings-vectorization-and-similarity.md)
-- [Design checklists](/docs/courses/shared/design-checklists.md)
+- [LLM basics](/docs/courses/shared/llm-basics-for-engineers)
+- [Tokenization](/docs/courses/shared/tokenization-and-context-windows)
+- [Embeddings](/docs/courses/shared/embeddings-vectorization-and-similarity)
+- [Design checklists](/docs/courses/shared/design-checklists)
 
 ### Then Continue With Lessons
 
diff --git a/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy.md b/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Completed Beginner Course or equivalent
-- [Design checklists](/docs/courses/shared/design-checklists.md)
+- [Design checklists](/docs/courses/shared/design-checklists)
 
 ---
 
@@ -287,5 +287,5 @@ Continue to [Lesson 2: Single-agent runtime and bounded autonomy](./lesson-2-sin
 
 ### Or Explore
 
-- [StateGraph concepts](/docs/concepts/state-graph.md) — Graph-based agent design
-- [Architecture concepts](/docs/concepts/architecture.md) — System architecture patterns
+- [StateGraph concepts](/docs/concepts/state-graph) — Graph-based agent design
+- [Architecture concepts](/docs/concepts/architecture) — System architecture patterns
diff --git a/docs/courses/genai-advanced/lesson-2-single-agent-runtime-and-bounded-autonomy.md b/docs/courses/genai-advanced/lesson-2-single-agent-runtime-and-bounded-autonomy.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Lesson 1: Architecture decisions
-- [StateGraph concepts](/docs/concepts/state-graph.md)
+- [StateGraph concepts](/docs/concepts/state-graph)
 
 ---
 
@@ -352,5 +352,5 @@ Continue to [Lesson 3: Context engineering, long context, and caching](./lesson-
 
 ### Or Explore
 
-- [React Agent Tutorial](/docs/tutorials/from-examples/react-agent.md) — ReAct implementation
-- [Testing Reference](/docs/reference/python/testing.md) — Testing bounded agents
+- [React Agent Tutorial](/docs/tutorials/from-examples/react-agent) — ReAct implementation
+- [Testing Reference](/docs/reference/python/testing) — Testing bounded agents
diff --git a/docs/courses/genai-advanced/lesson-3-context-engineering-long-context-and-caching.md b/docs/courses/genai-advanced/lesson-3-context-engineering-long-context-and-caching.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows.md)
+- [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows)
 - Lesson 2: Bounded autonomy
 
 ---
@@ -406,5 +406,5 @@ Continue to [Lesson 4: Knowledge systems and advanced RAG](./lesson-4-knowledge-
 
 ### Or Explore
 
-- [State and Messages concepts](/docs/concepts/state-and-messages.md) — State management
-- [Streaming concepts](/docs/concepts/streaming.md) — Streaming for latency
+- [State and Messages concepts](/docs/concepts/state-and-messages) — State management
+- [Streaming concepts](/docs/concepts/streaming) — Streaming for latency
diff --git a/docs/courses/genai-advanced/lesson-4-knowledge-systems-and-advanced-rag.md b/docs/courses/genai-advanced/lesson-4-knowledge-systems-and-advanced-rag.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- [Chunking and retrieval primitives](/docs/courses/shared/chunking-and-retrieval-primitives.md)
+- [Chunking and retrieval primitives](/docs/courses/shared/chunking-and-retrieval-primitives)
 - Lesson 3: Context engineering
 
 ---
@@ -438,5 +438,5 @@ Continue to [Lesson 5: Router, manager, and specialist patterns](./lesson-5-rout
 
 ### Or Explore
 
-- [Memory and Store concepts](/docs/concepts/memory-and-store.md) — Storage architecture
-- [Multi-agent Tutorial](/docs/tutorials/from-examples/multiagent.md) — Implementation patterns
+- [Memory and Store concepts](/docs/concepts/memory-and-store) — Storage architecture
+- [Multi-agent Tutorial](/docs/tutorials/from-examples/multiagent) — Implementation patterns
diff --git a/docs/courses/genai-advanced/lesson-5-router-manager-and-specialist-patterns.md b/docs/courses/genai-advanced/lesson-5-router-manager-and-specialist-patterns.md
@@ -409,5 +409,5 @@ Continue to [Lesson 6: Handoffs, human review, and control surfaces](./lesson-6-
 
 ### Or Explore
 
-- [Multi-agent Tutorial](/docs/tutorials/from-examples/multiagent.md) — Implementation
-- [Handoff Tutorial](/docs/tutorials/from-examples/handoff.md) — Agent transitions
+- [Multi-agent Tutorial](/docs/tutorials/from-examples/multiagent) — Implementation
+- [Handoff Tutorial](/docs/tutorials/from-examples/handoff) — Agent transitions
diff --git a/docs/courses/genai-advanced/lesson-6-handoffs-human-review-and-control-surfaces.md b/docs/courses/genai-advanced/lesson-6-handoffs-human-review-and-control-surfaces.md
@@ -25,7 +25,7 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Lesson 5: Multi-agent patterns
-- [Checkpointing concepts](/docs/concepts/checkpointing-and-threads.md)
+- [Checkpointing concepts](/docs/concepts/checkpointing-and-threads)
 
 ---
 
@@ -472,5 +472,5 @@ Continue to [Lesson 7: Memory, checkpoints, artifacts, and durable execution](./
 
 ### Or Explore
 
-- [Handoff Tutorial](/docs/tutorials/from-examples/handoff.md) — Implementation
-- [Background Tasks Reference](/docs/reference/python/background-tasks.md) — Long-running tasks
+- [Handoff Tutorial](/docs/tutorials/from-examples/handoff) — Implementation
+- [Background Tasks Reference](/docs/reference/python/background-tasks) — Long-running tasks
diff --git a/docs/courses/genai-advanced/lesson-7-memory-checkpoints-artifacts-and-durable-execution.md b/docs/courses/genai-advanced/lesson-7-memory-checkpoints-artifacts-and-durable-execution.md
@@ -496,5 +496,5 @@ Continue to [Lesson 8: Observability, testing, security, and deployment](./lesso
 
 ### Or Explore
 
-- [Checkpointers Reference](/docs/reference/python/checkpointers.md) — Implementation
-- [Memory Tutorial](/docs/tutorials/from-examples/memory.md) — Memory patterns
+- [Checkpointers Reference](/docs/reference/python/checkpointers) — Implementation
+- [Memory Tutorial](/docs/tutorials/from-examples/memory) — Memory patterns
diff --git a/docs/courses/genai-advanced/lesson-8-observability-testing-security-and-deployment.md b/docs/courses/genai-advanced/lesson-8-observability-testing-security-and-deployment.md
@@ -25,7 +25,7 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Lesson 7: Durable execution
-- [Production guides](/docs/how-to/production/deployment.md)
+- [Production guides](/docs/how-to/production/deployment)
 
 ---
 
@@ -413,5 +413,5 @@ Complete the [Architecture Review Exercise](./architecture-review-exercise.md) t
 
 ### Or Explore
 
-- [Deployment guide](/docs/how-to/production/deployment.md) — Deployment patterns
-- [Auth and authorization](/docs/how-to/production/auth-and-authorization.md) — Security implementation
+- [Deployment guide](/docs/how-to/production/deployment) — Deployment patterns
+- [Auth and authorization](/docs/how-to/production/auth-and-authorization) — Security implementation
diff --git a/docs/courses/genai-beginner/capstone.md b/docs/courses/genai-beginner/capstone.md
@@ -317,6 +317,6 @@ You built a complete GenAI application with:
 
 After completing this capstone:
 
-1. **Deploy to production** — Follow the [Deployment guide](/docs/how-to/production/deployment.md)
+1. **Deploy to production** — Follow the [Deployment guide](/docs/how-to/production/deployment)
 2. **Add more features** — Implement additional tools, more complex retrieval
-3. **Take the Advanced course** — [Start with Lesson 1](/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy.md)
+3. **Take the Advanced course** — [Start with Lesson 1](/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy)
diff --git a/docs/courses/genai-beginner/index.md b/docs/courses/genai-beginner/index.md
@@ -91,23 +91,23 @@ flowchart TB
 
 | Concept | Where It's Used |
 |---------|----------------|
-| [StateGraph](/docs/concepts/state-graph.md) | Lesson 1+ |
-| [Tools and validation](/docs/concepts/agents-and-tools.md) | Lesson 3 |
-| [Structured outputs](/docs/reference/python/agent.md) | Lesson 2, 7 |
-| [Memory and stores](/docs/concepts/memory-and-store.md) | Lesson 4, 5 |
-| [Checkpointing](/docs/concepts/checkpointing-and-threads.md) | Lesson 5 |
-| [Streaming](/docs/concepts/streaming.md) | Lesson 5, 6 |
-| [Client integration](/docs/get-started/connect-client.md) | Lesson 6 |
+| [StateGraph](/docs/concepts/state-graph) | Lesson 1+ |
+| [Tools and validation](/docs/concepts/agents-and-tools) | Lesson 3 |
+| [Structured outputs](/docs/reference/python/agent) | Lesson 2, 7 |
+| [Memory and stores](/docs/concepts/memory-and-store) | Lesson 4, 5 |
+| [Checkpointing](/docs/concepts/checkpointing-and-threads) | Lesson 5 |
+| [Streaming](/docs/concepts/streaming) | Lesson 5, 6 |
+| [Client integration](/docs/get-started/connect-client) | Lesson 6 |
 
 ## Your Learning Path
 
 ### Start Here
 
 If you're new to AgentFlow, start with these shared foundations:
 
-1. [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers.md) — What LLMs are
-2. [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows.md) — Why tokens matter
-3. [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet.md) — Reliable prompting
+1. [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers) — What LLMs are
+2. [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows) — Why tokens matter
+3. [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet) — Reliable prompting
 
 ### Then Continue With Lessons
 
@@ -117,12 +117,12 @@ Start with [Lesson 1: Use cases, models, and the LLM app lifecycle](./lesson-1-u
 
 After completing this course, you'll be ready for:
 
-- **Advanced Course**: [Agentic product fit and system boundaries](/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy.md)
-- **Production deployment**: [How-to guides](/docs/how-to/api-cli/initialize-project.md)
+- **Advanced Course**: [Agentic product fit and system boundaries](/docs/courses/genai-advanced/lesson-1-agentic-product-fit-and-system-bounded-autonomy)
+- **Production deployment**: [How-to guides](/docs/how-to/api-cli/initialize-project)
 - **Real projects**: Build your own GenAI applications
 
 :::note Coming from the Beginner Path?
-If you've already completed the [Beginner Path](/docs/beginner/index.md), this course goes deeper into the "why" and "when" of GenAI system design. The lessons will feel familiar but with more context.
+If you've already completed the [Beginner Path](/docs/beginner), this course goes deeper into the "why" and "when" of GenAI system design. The lessons will feel familiar but with more context.
 :::
 
 ---
diff --git a/docs/courses/genai-beginner/lesson-1-use-cases-models-and-app-lifecycle.md b/docs/courses/genai-beginner/lesson-1-use-cases-models-and-app-lifecycle.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- Read [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers.md) for foundational context
+- Read [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers) for foundational context
 
 ---
 
@@ -480,6 +480,6 @@ Continue to [Lesson 2: Prompting, context engineering, and structured outputs](.
 
 ### Or Explore
 
-- [AgentFlow Architecture](/docs/concepts/architecture.md) — How AgentFlow packages fit together
-- [StateGraph concepts](/docs/concepts/state-graph.md) — The core graph structure
-- [First Python Agent tutorial](/docs/get-started/first-python-agent.md) — Hands-on implementation
+- [AgentFlow Architecture](/docs/concepts/architecture) — How AgentFlow packages fit together
+- [StateGraph concepts](/docs/concepts/state-graph) — The core graph structure
+- [First Python Agent tutorial](/docs/get-started/first-agent) — Hands-on implementation
diff --git a/docs/courses/genai-beginner/lesson-2-prompting-context-and-structured-outputs.md b/docs/courses/genai-beginner/lesson-2-prompting-context-and-structured-outputs.md
@@ -24,9 +24,9 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- Read [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers.md) for failure mode context
-- Read [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet.md) for pattern reference
-- Read [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows.md) for context management
+- Read [LLM basics for engineers](/docs/courses/shared/llm-basics-for-engineers) for failure mode context
+- Read [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet) for pattern reference
+- Read [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows) for context management
 
 ---
 
@@ -632,6 +632,6 @@ Continue to [Lesson 3: Tools, files, and MCP basics](./lesson-3-tools-files-and-
 
 ### Or Explore
 
-- [Tools Reference](/docs/reference/python/tools.md) — AgentFlow tool patterns
-- [Agents and Tools concepts](/docs/concepts/agents-and-tools.md) — Tool design principles
-- [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet.md) — Pattern reference
+- [Tools Reference](/docs/reference/python/tools) — AgentFlow tool patterns
+- [Agents and Tools concepts](/docs/concepts/agents-and-tools) — Tool design principles
+- [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet) — Pattern reference
diff --git a/docs/courses/genai-beginner/lesson-3-tools-files-and-mcp-basics.md b/docs/courses/genai-beginner/lesson-3-tools-files-and-mcp-basics.md
@@ -25,8 +25,8 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Lesson 2: Prompting and structured outputs
-- [Agents and Tools concepts](/docs/concepts/agents-and-tools.md)
-- [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet.md)
+- [Agents and Tools concepts](/docs/concepts/agents-and-tools)
+- [Prompt patterns cheatsheet](/docs/courses/shared/prompt-and-output-patterns-cheatsheet)
 
 ---
 
@@ -611,6 +611,6 @@ Continue to [Lesson 4: Retrieval, grounding, and citations](./lesson-4-retrieval
 
 ### Or Explore
 
-- [MCP Client Tutorial](/docs/tutorials/from-examples/mcp-client.md) — Using MCP in AgentFlow
-- [Media and Files concepts](/docs/concepts/media-and-files.md) — File handling in depth
-- [Tools Reference](/docs/reference/python/tools.md) — Complete tool API reference
+- [MCP Client Tutorial](/docs/tutorials/from-examples/mcp-client) — Using MCP in AgentFlow
+- [Media and Files concepts](/docs/concepts/media-and-files) — File handling in depth
+- [Tools Reference](/docs/reference/python/tools) — Complete tool API reference
diff --git a/docs/courses/genai-beginner/lesson-4-retrieval-grounding-and-citations.md b/docs/courses/genai-beginner/lesson-4-retrieval-grounding-and-citations.md
@@ -24,8 +24,8 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- Read [Embeddings and similarity](/docs/courses/shared/embeddings-vectorization-and-similarity.md)
-- Read [Chunking and retrieval primitives](/docs/courses/shared/chunking-and-retrieval-primitives.md)
+- Read [Embeddings and similarity](/docs/courses/shared/embeddings-vectorization-and-similarity)
+- Read [Chunking and retrieval primitives](/docs/courses/shared/chunking-and-retrieval-primitives)
 
 ---
 
@@ -357,5 +357,5 @@ Continue to [Lesson 5: State, memory, threads, and streaming](./lesson-5-state-m
 
 ### Or Explore
 
-- [Qdrant Memory Tutorial](/docs/tutorials/from-examples/qdrant-memory.md) — Vector store setup
-- [Memory and Store concepts](/docs/concepts/memory-and-store.md) — Memory architecture
+- [Qdrant Memory Tutorial](/docs/tutorials/from-examples/qdrant-memory) — Vector store setup
+- [Memory and Store concepts](/docs/concepts/memory-and-store) — Memory architecture
diff --git a/docs/courses/genai-beginner/lesson-5-state-memory-threads-and-streaming.md b/docs/courses/genai-beginner/lesson-5-state-memory-threads-and-streaming.md
@@ -23,8 +23,8 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- Read [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows.md)
-- [Checkpointing and threads concepts](/docs/concepts/checkpointing-and-threads.md)
+- Read [Tokenization and context windows](/docs/courses/shared/tokenization-and-context-windows)
+- [Checkpointing and threads concepts](/docs/concepts/checkpointing-and-threads)
 
 ---
 
@@ -390,5 +390,5 @@ Continue to [Lesson 6: Multimodal and client/server integration](./lesson-6-mult
 
 ### Or Explore
 
-- [Streaming concepts](/docs/concepts/streaming.md) — Streaming architecture
-- [React Streaming Tutorial](/docs/tutorials/from-examples/react-streaming.md) — Frontend integration
+- [Streaming concepts](/docs/concepts/streaming) — Streaming architecture
+- [React Streaming Tutorial](/docs/tutorials/from-examples/react-streaming) — Frontend integration
diff --git a/docs/courses/genai-beginner/lesson-6-multimodal-and-client-server-integration.md b/docs/courses/genai-beginner/lesson-6-multimodal-and-client-server-integration.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 ## Prerequisites
 
 - Lesson 5: State and memory
-- [Streaming concepts](/docs/concepts/streaming.md)
+- [Streaming concepts](/docs/concepts/streaming)
 
 ---
 
@@ -441,5 +441,5 @@ Continue to [Lesson 7: Evals, safety, cost, and release](./lesson-7-evals-safety
 
 ### Or Explore
 
-- [Connect Client Tutorial](/docs/get-started/connect-client.md) — Full client integration
-- [Playground Tutorial](/docs/get-started/open-playground.md) — Using the playground
+- [Connect Client Tutorial](/docs/get-started/connect-client) — Full client integration
+- [Playground Tutorial](/docs/how-to/api-cli/open-playground) — Using the playground
diff --git a/docs/courses/genai-beginner/lesson-7-evals-safety-cost-and-release.md b/docs/courses/genai-beginner/lesson-7-evals-safety-cost-and-release.md
@@ -24,7 +24,7 @@ By the end of this lesson, you will be able to:
 
 ## Prerequisites
 
-- [Evaluation Reference](/docs/reference/python/evaluation.md)
+- [Evaluation Reference](/docs/reference/python/evaluation)
 
 ---
 
@@ -433,5 +433,5 @@ Complete the [Capstone Project](./capstone.md) to build your complete GenAI appl
 
 ### Or Explore
 
-- [Evaluation Reference](/docs/reference/python/evaluation.md) — AgentFlow eval tools
-- [Production Deployment](/docs/how-to/production/deployment.md) — Going to production
+- [Evaluation Reference](/docs/reference/python/evaluation) — AgentFlow eval tools
+- [Production Deployment](/docs/how-to/production/deployment) — Going to production
diff --git a/docs/courses/shared/evaluation-worksheet.md b/docs/courses/shared/evaluation-worksheet.md
diff --git a/docs/courses/shared/release-checklist.md b/docs/courses/shared/release-checklist.md
diff --git a/docs/how-to/production/index.md b/docs/how-to/production/index.md
diff --git a/docs/providers/index.md b/docs/providers/index.md
diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
diff --git a/tsconfig.json b/tsconfig.json
