diff --git a/docs_new/framework-overview/design-and-architecture.mdx b/docs_new/framework-overview/design-and-architecture.mdx
index 6d66e554..f929cb8b 100644
--- a/docs_new/framework-overview/design-and-architecture.mdx
+++ b/docs_new/framework-overview/design-and-architecture.mdx
@@ -111,11 +111,11 @@ python agency.py
 
 ## Related Documentation
 
-<Card title="Tools" icon="wrench" href="./tools">
+<Card title="Tools" icon="wrench" href="../key-entities/tools">
   Learn how to create and use tools to enhance your agents' capabilities.
 </Card>
 
-<Card title="Agents" icon="user" href="./agents">
+<Card title="Agents" icon="user" href="../key-entities/agents">
   Understand how to define and configure agents within your agency.
 </Card>
 
diff --git a/docs_new/getting-started/quickstart.mdx b/docs_new/getting-started/quickstart.mdx
index 60f0830b..78c10576 100644
--- a/docs_new/getting-started/quickstart.mdx
+++ b/docs_new/getting-started/quickstart.mdx
@@ -109,4 +109,4 @@ Get up and running with Agency Swarm quickly by following these steps:
 
 - Learn how to create more Tools, Agents, and Agencies
 - Deploy in Production
-- Check out the [Examples](../examples) section for detailed tutorials
+- Check out the [Tutorials](../tutorials) section for detailed tutorials
diff --git a/docs_new/introduction/overview.mdx b/docs_new/introduction/overview.mdx
index 66728a94..51c4d724 100644
--- a/docs_new/introduction/overview.mdx
+++ b/docs_new/introduction/overview.mdx
@@ -30,5 +30,5 @@ Agency Swarm makes it easy to build collaborative AI systems by providing tools
 
 ## Next Steps
   - **[Installation Guide](../getting-started/installation)**: Detailed setup instructions
-  - **[Examples](../examples)**: Explore sample use cases
+  - **[Tutorials](../tutorials)**: Explore sample use cases
   - **[API Reference](../api-reference/api-reference)**: Full API documentation
diff --git a/docs_new/tutorials/tutorials.mdx b/docs_new/tutorials/tutorials.mdx
index 2b32df05..21bb5ece 100644
--- a/docs_new/tutorials/tutorials.mdx
+++ b/docs_new/tutorials/tutorials.mdx
@@ -110,5 +110,5 @@ icon: "play"
 </CardGroup>
 
 ## Next Steps
-- **[API Reference](./api-reference/api-reference)**
-- **[Advanced Topics](./advanced-topics)**
+- **[API Reference](../api-reference/api-reference)**
+- **[Advanced Topics](../advanced-topics)**