Merge pull request #45816 from github/repo-sync

Repo sync

Author: docs-bot

.github/workflows/sync-sdk-docs.yml

@@ -24,6 +24,7 @@ on:
     types: [opened, synchronize, reopened]
     paths:
       - '.github/workflows/sync-sdk-docs.yml'
+      - 'content/copilot/get-started/sdk-quickstart.md'
       - 'src/workflows/sync-sdk-docs/**'
 
 concurrency:
@@ -77,6 +78,10 @@ jobs:
       - name: Copy SDK docs
         run: |
           mkdir -p "$SDK_DOCS_TARGET"
+          # Pages relocated out of this tree into hand-authored content are not
+          # excluded here — they are removed by the RELOCATED_PAGES map in
+          # src/workflows/sync-sdk-docs/normalize-sdk-docs.ts, which also
+          # repoints inbound links at their new URLs.
           rsync -av --exclude='.validation/' --exclude='developer-docs/' "$SDK_TMP/docs/" "$SDK_DOCS_TARGET/"
           echo "Copied $(find "$SDK_DOCS_TARGET" -name '*.md' | wc -l | tr -d ' ') markdown files"
 

content/copilot/get-started/index.md

@@ -8,6 +8,7 @@ children:
   - /quickstart
   - /cli-quickstart
   - /quickstart-copilot-app
+  - /sdk-quickstart
   - /what-is-github-copilot
   - /plans
   - /features

…t/how-tos/copilot-sdk/getting-started.md …nt/copilot/get-started/sdk-quickstart.mdcontent/copilot/how-tos/copilot-sdk/getting-started.md renamed to content/copilot/get-started/sdk-quickstart.md content/copilot/how-tos/copilot-sdk/getting-started.md renamed to content/copilot/get-started/sdk-quickstart.md

@@ -1,21 +1,22 @@
 ---
 title: Build your first Copilot-powered app
-shortTitle: Getting Started
+shortTitle: Copilot SDK quickstart
+allowTitleToDifferFromFilename: true
 intro: >-
   In this tutorial, you'll use the Copilot SDK to build a command-line
   assistant. You'll start with the basics, add streaming responses, then add
   custom tools - giving Copilot the ability to call your code.
 versions:
-  fpt: '*'
-  ghec: '*'
+  feature: copilot
 redirect_from:
   - /copilot/how-tos/copilot-sdk/sdk-getting-started
-contentType: how-tos
+  - /copilot/how-tos/copilot-sdk/getting-started
+contentType: get-started
+category:
+  - Quickstarts
+  - Integrate Copilot with your tools
 ---
 
-<!-- markdownlint-disable GHD046 GHD005 -->
-<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->
-
 **What you'll build:**
 
 ```text

content/copilot/how-tos/copilot-sdk/auth/authenticate.md

@@ -404,5 +404,5 @@ const client = new CopilotClient({
 ## Next steps
 
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/auth/byok) - Learn how to use your own API keys
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started) - Build your first Copilot-powered app
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart) - Build your first Copilot-powered app
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/mcp) - Connect to external tools

content/copilot/how-tos/copilot-sdk/auth/byok.md

@@ -594,4 +594,4 @@ foundry model run phi-4-mini
 ## Next steps
 
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/auth) - Learn about all authentication methods
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started) - Build your first Copilot-powered app
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart) - Build your first Copilot-powered app

content/copilot/how-tos/copilot-sdk/features/hooks.md

@@ -890,7 +890,7 @@ For full type definitions, input/output field tables, and additional examples fo
 
 ## See also
 
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started)
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart)
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/custom-agents)
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/streaming-events)
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/troubleshooting/debugging)

content/copilot/how-tos/copilot-sdk/features/mcp.md

@@ -340,7 +340,7 @@ For detailed debugging guidance, see the **[AUTOTITLE](/copilot/how-tos/copilot-
 * [Model Context Protocol Specification](https://modelcontextprotocol.io/)
 * [MCP Servers Directory](https://github.com/modelcontextprotocol/servers) - Community MCP servers
 * [GitHub MCP Server](https://github.com/github/github-mcp-server) - Official GitHub MCP server
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started) - SDK basics and custom tools
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart) - SDK basics and custom tools
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/troubleshooting/debugging) - SDK-wide debugging
 
 ## See also

content/copilot/how-tos/copilot-sdk/features/skills.md

@@ -373,6 +373,6 @@ If multiple skills provide conflicting instructions:
 
 ## See also
 
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started#create-custom-agents) - Define specialized AI personas
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started#step-4-add-a-custom-tool) - Build your own tools
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart#create-custom-agents) - Define specialized AI personas
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart#step-4-add-a-custom-tool) - Build your own tools
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/mcp) - Connect external tool providers

content/copilot/how-tos/copilot-sdk/features/steering-and-queueing.md

@@ -546,7 +546,7 @@ class InteractiveChat {
 
 ## See also
 
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started): Set up a session and send messages
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart): Set up a session and send messages
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/custom-agents): Define specialized agents with scoped tools
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/hooks/hooks-overview): React to session lifecycle events
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/features/session-persistence): Resume sessions across restarts

content/copilot/how-tos/copilot-sdk/hooks/hooks-overview.md

@@ -277,6 +277,6 @@ const session = await client.createSession({
 
 ## See also
 
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started)
-* [AUTOTITLE](/copilot/how-tos/copilot-sdk/getting-started#step-4-add-a-custom-tool)
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart)
+* [AUTOTITLE](/copilot/get-started/sdk-quickstart#step-4-add-a-custom-tool)
 * [AUTOTITLE](/copilot/how-tos/copilot-sdk/troubleshooting/debugging)