Merge pull request #9550 from microsoft/ntrogh/redirect-prompt-engineering-guide

Redirect prompt engineering guide

Author: ntrogh

build/sitemap.xml

@@ -465,11 +465,6 @@
         <changefreq>weekly</changefreq>
         <priority>0.8</priority>
     </url>
-    <url>
-        <loc>https://code.visualstudio.com/docs/copilot/guides/prompt-engineering-guide</loc>
-        <changefreq>weekly</changefreq>
-        <priority>0.8</priority>
-    </url>
     <url>
         <loc>https://code.visualstudio.com/docs/copilot/guides/test-driven-development-guide</loc>
         <changefreq>weekly</changefreq>

docs/copilot/best-practices.md

@@ -84,7 +84,7 @@ The quality of AI responses depends on the clarity and specificity of your promp
 
 * **Parallel tasks.** If you have multiple independent tasks, ask the AI to run them in parallel to save time. For example, "Perform isolated research about X and Y in parallel and summarize the findings."
 
-For more information, see [prompt engineering](/docs/copilot/guides/prompt-engineering-guide.md) and find practical [prompt examples](https://docs.github.com/en/copilot/copilot-chat-cookbook) in the GitHub Copilot documentation.
+For more information, find practical [prompt examples](https://docs.github.com/en/copilot/copilot-chat-cookbook) in the GitHub Copilot documentation.
 
 ## Provide the right context
 
@@ -177,7 +177,6 @@ For more information, see [workspace context](/docs/copilot/reference/workspace-
 
 ## Related resources
 
-* [Prompt engineering guide](/docs/copilot/guides/prompt-engineering-guide.md)
 * [Context engineering guide](/docs/copilot/guides/context-engineering-guide.md)
 * [Customization overview](/docs/copilot/customization/overview.md)
 * [Cheat sheet](/docs/copilot/reference/copilot-vscode-features.md)

docs/copilot/chat/copilot-chat-context.md

@@ -185,5 +185,5 @@ If you want to reset the context entirely, start a [new chat session](/docs/copi
 
 * [Chat overview](/docs/copilot/chat/copilot-chat.md)
 * [Prompt examples](/docs/copilot/chat/prompt-examples.md)
-* [Prompt engineering guide](/docs/copilot/guides/prompt-engineering-guide.md)
+* [Prompt engineering guide](/docs/copilot/best-practices.md)
 * [Debug chat interactions](/docs/copilot/chat/chat-debug-view.md)

docs/copilot/chat/copilot-chat.md

@@ -158,7 +158,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/copilot/chat/prompt-examples.md) or review the full [prompt engineering guide](/docs/copilot/guides/prompt-engineering-guide.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/copilot/chat/prompt-examples.md) or review the full [prompt engineering guide](/docs/copilot/best-practices.md).
 
 * **Customize the AI**: tailor the AI's behavior to your project by adding [custom instructions](/docs/copilot/customization/custom-instructions.md), creating reusable [prompt files](/docs/copilot/customization/prompt-files.md), or building [custom agents](/docs/copilot/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.
 

docs/copilot/chat/prompt-examples.md

@@ -8,7 +8,7 @@ MetaSocialImage: ../images/shared/github-copilot-social.png
 
 This article provides example prompts for chat in Visual Studio Code across different scenarios and agents. Use these examples as inspiration to craft effective prompts for your own development tasks.
 
-If you are new to using chat in VS Code, learn more about [getting started with chat](/docs/copilot/chat/copilot-chat.md) or review [best practices for prompt crafting](/docs/copilot/guides/prompt-engineering-guide.md).
+If you are new to using chat in VS Code, learn more about [getting started with chat](/docs/copilot/chat/copilot-chat.md) or review [best practices for prompt crafting](/docs/copilot/best-practices.md).
 
 <div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Get started with agents">
 Follow a hands-on tutorial to experience local, background, and cloud agents in VS Code.
@@ -186,7 +186,7 @@ By building on earlier responses, the AI maintains context from the previous ste
 * **Iterate**: Start with a simple prompt and refine it based on the response. Ask follow-up questions to improve the results.
 * **Break down complex tasks**: Instead of asking for everything at once, break large tasks into smaller, manageable steps.
 
-Learn more about [best practices for crafting prompts](/docs/copilot/guides/prompt-engineering-guide.md) and [adding context to your prompts](/docs/copilot/chat/copilot-chat-context.md).
+Learn more about [best practices for crafting prompts](/docs/copilot/best-practices.md) and [adding context to your prompts](/docs/copilot/chat/copilot-chat-context.md).
 
 ## Related resources
 

docs/redirection.json

@@ -3,5 +3,6 @@
     { "from": "/docs/copilot/agents/background-agents", "to": "/docs/copilot/agents/copilot-cli", "status": 301 },
     { "from": "/docs/copilot/setup-simplified", "to": "/docs/copilot/setup", "status": 301 },
     { "from": "/docs/copilot/copilot-tips-and-tricks", "to": "/docs/copilot/best-practices", "status": 301 },
-    { "from": "/docs/typescript/typescript-compiling", "to": "/docs/typescript/typescript-transpiling", "status": 301 }
+    { "from": "/docs/typescript/typescript-compiling", "to": "/docs/typescript/typescript-transpiling", "status": 301 },
+    { "from": "/docs/copilot/guides/prompt-engineering-guide", "to": "/docs/copilot/best-practices", "status": 301 }
 ]

docs/toc.json

@@ -107,7 +107,6 @@
         "area": "copilot/guides",
         "noCollapse": false,
         "topics": [
-          ["Prompt Engineering", "/docs/copilot/guides/prompt-engineering-guide"],
           ["Context Engineering", "/docs/copilot/guides/context-engineering-guide"],
           ["Customize AI", "/docs/copilot/guides/customize-copilot-guide"],
           ["Test-Driven Development", "/docs/copilot/guides/test-driven-development-guide"],