diff --git a/docs/ai-python/content/docs/basics/index.mdx b/docs/ai-python/content/docs/basics/index.mdx
index edd2f318..82a8d4bd 100644
--- a/docs/ai-python/content/docs/basics/index.mdx
+++ b/docs/ai-python/content/docs/basics/index.mdx
@@ -38,7 +38,7 @@ needs those control points.
 
 ## Example map
 
-Focused samples live in `examples/samples/`:
+Focused samples live in `examples/`:
 
 - `stream.py` streams text from a model.
 - `tools_schema.py` passes a schema-only tool to a model.
@@ -47,5 +47,7 @@ Focused samples live in `examples/samples/`:
 - `streaming_tool.py` streams partial output from a tool.
 - `agent_nested.py` runs a subagent as a tool.
 
-End-to-end demos live in `examples/fastapi-vite`,
-`examples/multiagent-textual`, and `examples/temporal-direct`.
+End-to-end demos live in
+[`examples/fastapi-vite`](https://github.com/vercel-labs/ai-python/tree/main/examples/fastapi-vite),
+[`examples/multiagent-textual`](https://github.com/vercel-labs/ai-python/tree/main/examples/multiagent-textual),
+and [`examples/temporal-direct`](https://github.com/vercel-labs/ai-python/tree/main/examples/temporal-direct).
diff --git a/docs/ai-python/content/docs/index.mdx b/docs/ai-python/content/docs/index.mdx
index 7c894ab9..07f1c717 100644
--- a/docs/ai-python/content/docs/index.mdx
+++ b/docs/ai-python/content/docs/index.mdx
@@ -110,7 +110,11 @@ After iteration, `s.message`, `s.text`, `s.tool_calls`, `s.output`, and
 - **Streaming**: Stream model responses and inspect events.
 - **Agents**: Add tools, customize the loop, and handle approvals.
 - **Samples**: Focused, single-file examples live in
-  [`examples/samples/`](https://github.com/vercel-labs/ai-python/tree/main/examples/samples).
-- **End-to-end demos**: `fastapi-vite` (web chat with human-in-the-loop
-  approval), `multiagent-textual` (parallel agents with a terminal UI),
-  `temporal-direct` (durable agent runs).
+  [`examples/`](https://github.com/vercel-labs/ai-python/tree/main/examples).
+- **End-to-end demos**:
+  [`fastapi-vite`](https://github.com/vercel-labs/ai-python/tree/main/examples/fastapi-vite)
+  (web chat with human-in-the-loop approval),
+  [`multiagent-textual`](https://github.com/vercel-labs/ai-python/tree/main/examples/multiagent-textual)
+  (parallel agents with a terminal UI),
+  [`temporal-direct`](https://github.com/vercel-labs/ai-python/tree/main/examples/temporal-direct)
+  (durable agent runs).