Fix cross-references

ntrogh · ntrogh · commit 817d165a8114 · 2026-06-02T13:50:04.000+02:00
diff --git a/docs/agent-customization/agent-skills.md b/docs/agent-customization/agent-skills.md
@@ -300,7 +300,7 @@ To use a shared skill:
 1. Optionally, modify or add resources as needed
 
 > [!TIP]
-> Always review shared skills before using them to ensure they meet your requirements and security standards. VS Code's [terminal tool](/docs/agents/agent-tools.md#terminal-commands) provides controls for script execution, including [auto-approve options](/docs/agents/agent-tools.md#automatically-approve-terminal-commands) with configurable allow-lists and tight controls over which code runs. Learn more about [security considerations](/docs/agents/security.md#automated-approval) for auto-approval features.
+> Always review shared skills before using them to ensure they meet your requirements and security standards. VS Code's [terminal tool](/docs/agents/agent-tools.md#terminal-commands) provides controls for script execution, including [auto-approve options](/docs/agents/agent-tools.md#automatically-approve-terminal-commands) with configurable allow-lists and tight controls over which code runs. Learn more about [security considerations](/docs/agents/security.md#approvals-and-review) for auto-approval features.
 
 ## Contribute skills from extensions
 
diff --git a/docs/agent-customization/custom-agents.md b/docs/agent-customization/custom-agents.md
@@ -45,7 +45,7 @@ Different tasks require different capabilities. A planning agent might only need
 Custom agents also let you provide specialized instructions that define how the AI should operate. For instance, a planning agent could instruct the AI to collect project context and generate a detailed implementation plan, while a code review agent might focus on identifying security vulnerabilities and suggesting improvements. These specialized instructions ensure consistent, task-appropriate responses every time you switch to that agent.
 
 > [!NOTE]
-> Subagents can run with a custom agent. Learn more about running [subagents with custom agents](/docs/agents/subagents.md#run-a-custom-agent-as-a-subagent-experimental) (experimental).
+> Subagents can run with a custom agent. Learn more about running [subagents with custom agents](/docs/agents/subagents.md#run-a-custom-agent-as-a-subagent) (experimental).
 
 ## Handoffs
 
diff --git a/docs/agent-customization/language-models.md b/docs/agent-customization/language-models.md
@@ -43,7 +43,7 @@ Some models support configurable thinking effort, which controls how much reason
 By default, VS Code sets recommended effort levels and has adaptive reasoning enabled, where the model dynamically determines how much to think based on the complexity of each request. For most use cases, the defaults work well.
 
 > [!TIP]
-> Higher thinking effort produces more thinking tokens, which increases [AI credit](/docs/copilot/concepts/language-models.md#ai-credits-and-model-costs) consumption. Only increase thinking effort for genuinely complex tasks. Learn more about [optimizing AI credit usage](/docs/copilot/guides/optimize-usage.md).
+> Higher thinking effort produces more thinking tokens, which increases [AI credit](/docs/agents/concepts/language-models.md#ai-credits-and-model-costs) consumption. Only increase thinking effort for genuinely complex tasks. Learn more about [optimizing AI credit usage](/docs/agents/guides/optimize-usage.md).
 
 To configure the thinking effort:
 
@@ -69,13 +69,13 @@ With auto model selection, VS Code evaluates task complexity and real-time model
 
 To use auto model selection, select **Auto** from the model picker in chat. You can see which model is used for generating a response by hovering over the chat response.
 
-![Screenshot of a chat response, showing the selected model on hover.](../images/language-models/chat-response-selected-model.png)
+![Screenshot of a chat response, showing the selected model on hover.](images/language-models/chat-response-selected-model.png)
 
 ## Manage language models
 
 You can use the language models editor to view all available models, choose which models are shown in the model picker, and add more models by adding from built-in providers or from extension-provided model providers.
 
-To open the Language Models editor, open the model picker in the Chat view and select **Manage Language Models** (gear icon) or run the **Chat: Manage Language Models** command from the Command Palette. The Language Models editor opens by default in a [modal overlay](/docs/getstarted/userinterface.md#modal-editors) on top of the editor area.
+To open the Language Models editor, open the model picker in the Chat view and select **Manage Language Models** (gear icon) or run the **Chat: Manage Language Models** command from the Command Palette. The Language Models editor opens by default in a [modal overlay](/docs/editing/userinterface.md#modal-editors) on top of the editor area.
 
 ![Screenshot that shows the Language Models editor.](images/language-models/language-models-editor.png)
 
@@ -94,7 +94,7 @@ You can customize which models are shown in the model picker by changing the vis
 
 Hover over a model in the list and select the eye icon to show or hide the model in the model picker.
 
-![Screenshot that shows the Language Models editor with the eye icon to show or hide models in the model picker.](../images/language-models/language-models-hide.png)
+![Screenshot that shows the Language Models editor with the eye icon to show or hide models in the model picker.](images/language-models/language-models-hide.png)
 
 ### Pin favorite models
 
@@ -140,7 +140,7 @@ To configure a language model from a built-in provider:
 
 1. Select **Add Models**, and then select a model provider from the list.
 
-    ![Screenshot that shows the model provider Quick Pick.](../images/language-models/model-provider-quick-pick-v2.png)
+    ![Screenshot that shows the model provider Quick Pick.](images/language-models/model-provider-quick-pick-v2.png)
 
 1. Enter a group name for the models. This is the grouping label shown in the model picker and Language Models editor.
 
diff --git a/docs/agents/best-practices.md b/docs/agents/best-practices.md
@@ -135,7 +135,7 @@ Each AI model has different strengths. Some are better at reasoning, others exce
 
 * **Consider credit consumption.** More capable models consume more [AI credits](/docs/agents/concepts/language-models.md#ai-credits-and-model-costs) per token. Auto model selection balances quality and cost automatically. For more tips, see [optimize AI credit usage](/docs/agents/guides/optimize-usage.md).
 
-For more information, see [selecting AI models](/docs/agents/customization/language-models.md) and [available models for Copilot Chat](https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat).
+For more information, see [selecting AI models](/docs/agent-customization/language-models.md) and [available models for Copilot Chat](https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat).
 
 ## Plan first, then implement
 
@@ -186,7 +186,7 @@ For more information, see [session management](/docs/agents/sessions/chat-sessio
 
 Copilot is designed to work effectively with large, complex, and multi-root workspaces. Use these practices to get the best results at scale.
 
-* **Use workspace indexing.** VS Code automatically indexes your project using semantic search, language intelligence, and GitHub's code search for deep cross-file reasoning. This works for both small projects and large enterprise codebases. For large repositories, use [remote indexing](/docs/agents/reference/workspace-context.md#remote-index) for fast, comprehensive results across your repository and related repositories on GitHub.
+* **Use workspace indexing.** VS Code automatically indexes your project using semantic search, language intelligence, and GitHub's code search for deep cross-file reasoning. This works for both small projects and large enterprise codebases. For large repositories, use [remote indexing](/docs/agents/reference/workspace-context.md#semantic-index-sources) for fast, comprehensive results across your repository and related repositories on GitHub.
 
 * **Scope work with multi-root workspaces.** For monorepos or projects with multiple services, use [multi-root workspaces](/docs/editing/workspaces/multi-root-workspaces.md) to give the AI clear boundaries and focused context.
 
diff --git a/docs/agents/security.md b/docs/agents/security.md
@@ -45,7 +45,7 @@ VS Code's security model uses trust boundaries to limit the potential impact of
 * **Workspace**: controls whether VS Code enables features like tasks, debugging, and workspace settings that can execute code from the project. An untrusted workspace runs in [restricted mode](/docs/editing/workspaces/workspace-trust.md), which also disables agents.
 * **Extension publisher**: controls whether extensions from a given publisher can be installed and run. VS Code prompts you to [trust the publisher](/docs/configure/extensions/extension-runtime-security.md) before activating their extensions.
 * **MCP server**: controls whether an MCP server can start and provide tools. VS Code prompts you to [trust each MCP server](/docs/agent-customization/mcp-servers.md#mcp-server-trust) before it runs, and re-prompts after configuration changes.
-* **Network domain**: controls whether the agent can fetch content from a URL. VS Code prompts you to trust a domain before making requests to it, integrated with the [Trusted Domains](/docs/editing/editingevolved.md#_outgoing-link-protection) list. You can also enable `setting(chat.agent.networkFilter)` to restrict which domains agent tools (fetch tool, integrated browser) and sandboxed terminal commands can access. Learn more about [network filtering](/docs/agents/agent-tools.md#configure-network-access).
+* **Network domain**: controls whether the agent can fetch content from a URL. VS Code prompts you to trust a domain before making requests to it, integrated with the [Trusted Domains](/docs/editing/editingevolved.md#outgoing-link-protection) list. You can also enable `setting(chat.agent.networkFilter)` to restrict which domains agent tools (fetch tool, integrated browser) and sandboxed terminal commands can access. Learn more about [network filtering](/docs/agents/agent-tools.md#configure-network-access).
 
 You can revoke trust at any time through dedicated commands in the Command Palette.
 
diff --git a/docs/chat/copilot-chat-context.md b/docs/chat/copilot-chat-context.md
@@ -129,11 +129,11 @@ The context window control provides the following information:
 As you send more requests in a conversation, the control updates to reflect the increasing context usage. The total available context (denominator) changes based on the AI model you select, since different models have different context window sizes.
 
 > [!TIP]
-> When the context window fills up, VS Code automatically [compacts the conversation history](#context-compaction) to free up space.
+> When the context window fills up, VS Code automatically compacts the conversation history to free up space.
 
 ## Context compaction
 
-As a conversation grows, the accumulated messages and context can fill up the model's context window. Context compaction summarizes the conversation history to free up space, so you can continue working in the same session without losing important details. Compacting also reduces the number of tokens sent with each subsequent request, which helps manage [AI credit consumption](/docs/copilot/guides/optimize-usage.md).
+As a conversation grows, the accumulated messages and context can fill up the model's context window. Context compaction summarizes the conversation history to free up space, so you can continue working in the same session without losing important details. Compacting also reduces the number of tokens sent with each subsequent request, which helps manage [AI credit consumption](/docs/agents/guides/optimize-usage.md).
 
 ### Automatic compaction
 
@@ -155,7 +155,7 @@ If you want to reset the context entirely, start a [new chat session](/docs/agen
 
 ## Related resources
 
-* [Chat overview](/docs/chat/copilot-chat.md)
-* [Prompt examples](/docs/chat/prompt-examples.md)
+* [Chat overview](/docs/agents/chat-view.md)
+* [Prompt examples](/docs/agents/guides/prompt-examples.md)
 * [Prompt engineering guide](/docs/agents/best-practices.md)
 * [Debug chat interactions](/docs/agents/agent-troubleshooting/chat-debug-view.md)
diff --git a/docs/chat/copilot-chat.md b/docs/chat/copilot-chat.md
@@ -23,7 +23,7 @@ Follow a hands-on tutorial to experience local, background, and cloud agents in
 * Access to [GitHub Copilot](/docs/setup/copilot.md). If you don't have a subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup).
 
 > [!IMPORTANT]
-> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, Max, and Student plans are temporarily paused. 
+> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, Max, and Student plans are temporarily paused.
 
 ## Access chat in VS Code
 
@@ -111,7 +111,7 @@ After the AI makes changes to your files, review and accept or discard them.
 
 Chat provides several ways to improve the quality and relevance of AI responses:
 
-* **Write effective prompts**: be specific about what you want, reference relevant files and symbols, and use `/` commands for common tasks. Get inspired by [prompt examples](/docs/chat/prompt-examples.md) or review the full [prompt engineering guide](/docs/agents/best-practices.md).
+* **Write effective prompts**: be specific about what you want, reference relevant files and symbols, and use `/` commands for common tasks. Get inspired by [prompt examples](/docs/agents/guides/prompt-examples.md) or review the full [prompt engineering guide](/docs/agents/best-practices.md).
 
 * **Customize the AI**: tailor the AI's behavior to your project by adding [custom instructions](/docs/agent-customization/custom-instructions.md), creating reusable [prompt files](/docs/agent-customization/prompt-files.md), or building [custom agents](/docs/agent-customization/custom-agents.md) for specialized workflows. For example, create a "Code Reviewer" agent that provides feedback on code quality and adherence to your team's coding standards.
 
@@ -135,4 +135,4 @@ To learn more about Copilot's security, privacy, compliance, and transparency, s
 
 * [Choose agents and configure permissions](/docs/agents/overview.md)
 
-* [Prompt examples](/docs/chat/prompt-examples.md)
+* [Prompt examples](/docs/agents/guides/prompt-examples.md)
