diff --git a/docs/agents/streaming.md b/docs/agents/streaming.md
index 3b8d53cd..4059d751 100644
--- a/docs/agents/streaming.md
+++ b/docs/agents/streaming.md
@@ -102,7 +102,7 @@ Streaming is supported by these providers:
 - **OpenRouter** - Most models with streaming capability
 - **Ollama** - Local models with streaming support
 
-See the [providers documentation](/docs/providers) for provider-specific configuration.
+See the [providers documentation](/providers) for provider-specific configuration.
 
 ## Best Practices
 
diff --git a/docs/examples/data_extraction_agent.md b/docs/examples/data_extraction_agent.md
index 948792b7..bbd678dc 100644
--- a/docs/examples/data_extraction_agent.md
+++ b/docs/examples/data_extraction_agent.md
@@ -76,7 +76,7 @@ Generate schemas dynamically from your models:
 - Schema mirrors database structure
 - Single source of truth for validations
 
-Learn more: [Structured Output](/actions/structured-output#schema-generation)
+Learn more: [Structured Output](/actions/structured_output#schema-generation)
 
 ## Common Patterns
 
@@ -134,7 +134,7 @@ OpenAI's GPT-4o models provide the best balance of accuracy and speed for resume
 
 ## See Also
 
-- [Structured Output](/actions/structured-output) - JSON schema validation
+- [Structured Output](/actions/structured_output) - JSON schema validation
 - [Messages](/actions/messages) - Multimodal content (PDFs, images)
-- [OpenAI Provider](/providers/open-ai) - Configuration details
-- [OpenRouter Provider](/providers/open-router) - Alternative provider with 200+ models
+- [OpenAI Provider](/providers/open_ai) - Configuration details
+- [OpenRouter Provider](/providers/open_router) - Alternative provider with 200+ models
diff --git a/docs/framework/instrumentation.md b/docs/framework/instrumentation.md
index 72e4c743..fc10801b 100644
--- a/docs/framework/instrumentation.md
+++ b/docs/framework/instrumentation.md
@@ -263,8 +263,8 @@ CustomAgentLogger.attach_to :active_agent
 
 ## Related Documentation
 
-- **[Agents](/framework/agents)** - Learn about agent lifecycle, callbacks, and the generation cycle
+- **[Agents](/agents)** - Learn about agent lifecycle, callbacks, and the generation cycle
 - **[Callbacks](/agents/callbacks)** - Understand callback hooks like `before_generation` and `after_generation`
-- **[Providers](/framework/providers)** - Explore provider-specific behavior and configuration
+- **[Providers](/providers)** - Explore provider-specific behavior and configuration
 - **[Testing](/framework/testing)** - Test agents and instrumentation in your test suite
 - **[Configuration](/framework/configuration)** - Configure instrumentation behavior across environments
diff --git a/docs/providers/mock.md b/docs/providers/mock.md
index 014af400..7933a925 100644
--- a/docs/providers/mock.md
+++ b/docs/providers/mock.md
@@ -102,7 +102,7 @@ The Mock provider accepts structured output parameters but doesn't validate or e
 
 ## Related Documentation
 
-- [Providers Overview](/framework/providers)
+- [Providers Overview](/providers)
 - [Anthropic Provider](/providers/anthropic) - Anthropic Claude configuration
 - [Configuration Guide](/getting_started#configuration)
 - [Testing Guide](/framework/testing)
diff --git a/docs/providers/ollama.md b/docs/providers/ollama.md
index 3f2fe304..09e19f9d 100644
--- a/docs/providers/ollama.md
+++ b/docs/providers/ollama.md
@@ -226,7 +226,7 @@ Ollama-specific error handling for connection failures and missing models. For c
 - [Embeddings Framework](/actions/embeddings) - Complete guide to embeddings
 - [Configuration](/framework/configuration) - Global provider setup
 - [Structured Output](/actions/structured_output) - Structured output patterns
-- [Providers Overview](/framework/providers) - Provider comparison
+- [Providers Overview](/providers) - Provider comparison
 - [Configuration Guide](/getting_started#configuration) - Setup and configuration
 - [Error Handling](/agents/error_handling) - Error handling strategies
 - [Ollama Documentation](https://ollama.ai/docs) - Official Ollama docs