Merge branch 'main' into patch-1

Author: Sharra-writes

.github/actions/slack-alert/action.yml

@@ -2,28 +2,27 @@ name: Send Slack notification if workflow fails
 description: Send Slack notification if workflow fails
 
 inputs:
-  slack_channel_id:
-    description: Slack channel ID
-    required: true
   slack_token:
     description: Slack token
     required: true
+  slack_channel_id:
+    description: Slack channel ID. Defaults to the docs-alerts channel (CG5MJHMB2).
+    default: CG5MJHMB2 # docs-alerts
+    required: false
   message:
     description: The message to send to Slack
     default: The last '${{ github.workflow }}' run failed. See ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
     required: false
-  color:
-    description: The color of the Slack message
-    default: failure
-    required: false
 
 runs:
   using: composite
   steps:
     - name: Send Slack notification if workflow fails
-      uses: someimportantcompany/github-actions-slack-message@a975b440de2bcef178d451cc70d4c1161b5a30cd
+      uses: slackapi/slack-github-action@45a88b9581bfab2566dc881e2cd66d334e621e2c # v3.0.3
       with:
-        channel: ${{ inputs.slack_channel_id }}
-        bot-token: ${{ inputs.slack_token }}
-        color: ${{ inputs.color }}
-        text: ${{ inputs.message }}
+        method: chat.postMessage
+        token: ${{ inputs.slack_token }}
+        errors: true
+        payload: |
+          channel: ${{ toJSON(inputs.slack_channel_id) }}
+          text: ${{ toJSON(inputs.message) }}

.github/copilot-instructions.md

@@ -31,6 +31,10 @@ updates:
       day: tuesday
     cooldown:
       default-days: 7
+    groups:
+      actions:
+        patterns:
+          - '*'
     ignore:
       - dependency-name: '*'
         update-types:

.github/dependabot.yml

@@ -4,7 +4,7 @@ applyTo: "**"
 
 # Copilot instructions for docs.github.com
 
-This repository contains code to run the GitHub Docs site on docs.github.com, as well as the content that the site displays. We write the code in JavaScript and TypeScript, and we write the content primarily in Markdown.
+This repository powers the GitHub Docs site (docs.github.com). It contains both the Next.js application code (TypeScript) and the documentation content (Markdown).
 
 ## Creating a pull request
 
@@ -29,6 +29,8 @@ When you create a pull request:
 3. Label with "llm-generated". 
 4. If an issue exists, include "fixes owner/repo#issue" or "towards owner/repo#issue" as appropriate. 
 5. Always create PRs in **draft mode** using `--draft` flag.
+6. Do not commit directly to `main`.
+7. Whenever you create or comment on an issue or pull request, indicate you are GitHub Copilot.
 
 ## Accessing docs.github.com content programmatically
 

.github/instructions/all.instructions.md

@@ -11,13 +11,11 @@ For code reviews, follow guidelines, tests, and validate instructions. For creat
 - If available, use ripgrep (`rg`) instead of `grep`.
 - When using gh cli in double-quoted strings, escape backticks to prevent bash command substitution. In single-quoted strings, backticks do not need escaping.
 - All scripts should be listed in `package.json` and use `tsx`.
-- Whenever you create or comment on an issue or pull request, indicate you are GitHub Copilot.
 - Be careful fetching full HTML pages off the internet. Prefer to use MCP or gh cli whenever possible for github.com. Limit the number of tokens when grabbing HTML.
 - Avoid pull requests with over 300 lines of code changed. When significantly larger, offer to split up into smaller pull requests if possible.
 - All new code should be written in TypeScript and not JavaScript.
 - We use absolute imports, relative to the `src` directory, using the `@` symbol. For example, `getRedirect` which lives in `src/redirects/lib/get-redirect.ts` can be imported with `import getRedirect from '@/redirects/lib/get-redirect'`. The same rule applies for TypeScript (`.ts`) imports, e.g. `import type { GeneralSearchHit } from '@/search/types'`
 - For updates to the content linter, read important information in `src/content-linter/README.md`.
-- Do not commit to `main` branch.
 - Do not use git force push, and avoid git rebase.
 
 ## Tests

.github/instructions/code.instructions.md

@@ -6,7 +6,7 @@ applyTo: "content/**,data/**,**/*.md"
 
 **When to use**: Any content editing, documentation writing, or Markdown file changes. This is a condensed version of the full style guide at `/content/contributing/style-guide-and-content-model/style-guide.md`. Use these rules for routine work. Only consult the full style guide if you encounter a style question not covered here.
 
-For Liquid variable usage, reusables, linking conventions, bullet-list formatting, and parenthetical dashes, see `content.instructions.md` (loaded automatically alongside this file).
+For Liquid variable usage, reusables, linking conventions, bullet-list markers, and parenthetical dashes, see `content.instructions.md` (loaded automatically alongside this file).
 
 ## Core principles
 
@@ -52,15 +52,13 @@ For Liquid variable usage, reusables, linking conventions, bullet-list formattin
 
 ## Links
 
-* Use `[AUTOTITLE](/path/to/article)` for all internal links. Never hardcode article titles in link text.
 * Introduce links with "For more information, see" or "See" when context is clear.
 * Do not use inline links where words within a sentence are hyperlinked without additional context.
 * Do not include punctuation inside a hyperlink.
 * Do not repeat the same link more than once in the same article.
 
 ## Lists
 
-* Use `*` (asterisks) for unordered lists, never `-` (hyphens).
 * Capitalize the first letter of each list item.
 * Use periods only if the item is a complete sentence.
 * Introduce lists with a descriptive sentence, not vague phrases like "the following" in isolation.
@@ -83,9 +81,8 @@ For Liquid variable usage, reusables, linking conventions, bullet-list formattin
 * Use full words for Apple modifier keys (`Command`, `Option`, `Control`), not symbols.
 * Capitalize letter keys.
 
-## Product names and variables
+## Product names
 
-* Always use Liquid variables for product names—never hardcode them. Check `data/variables/product.yml` and `data/variables/copilot.yml`.
 * Product names are always singular (for example, "GitHub Actions helps" not "help").
 
 ## Word choice

.github/instructions/style-guide-summary.instructions.md

@@ -161,7 +161,6 @@ jobs:
       - uses: ./.github/actions/slack-alert
         if: ${{ failure() && github.event_name != 'workflow_dispatch' }}
         with:
-          slack_channel_id: ${{ secrets.DOCS_ALERTS_SLACK_CHANNEL_ID }}
           slack_token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }}
 
       - uses: ./.github/actions/create-workflow-failure-issue

.github/workflows/benchmark-pages.yml

@@ -112,10 +112,12 @@ jobs:
         if: steps.check_team.outputs.is_team_member == 'true'
         id: extract_issue
         uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        env:
+          PR_BODY: ${{ steps.resolve_pr.outputs.pr_body }}
         with:
           github-token: ${{ secrets.DOCS_BOT_PAT_BASE }}
           script: |
-            const body = `${{ steps.resolve_pr.outputs.pr_body }}`;
+            const body = process.env.PR_BODY || '';
 
             // Match closing keywords followed by docs-content issue references.
             // Supports: closes github/docs-content#123, fixes https://github.com/github/docs-content/issues/123
@@ -224,6 +226,10 @@ jobs:
         if: steps.check_parent.outputs.has_parent == 'true'
         id: gather_context
         uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        env:
+          PR_TITLE: ${{ steps.resolve_pr.outputs.pr_title }}
+          PR_BODY: ${{ steps.resolve_pr.outputs.pr_body }}
+          PR_URL: ${{ steps.resolve_pr.outputs.pr_url }}
         with:
           github-token: ${{ secrets.DOCS_BOT_PAT_BASE }}
           script: |
@@ -254,9 +260,9 @@ jobs:
             const changedFiles = files.map(f => f.filename);
 
             core.setOutput('pr_author', prAuthor);
-            core.setOutput('pr_title', '${{ steps.resolve_pr.outputs.pr_title }}');
-            core.setOutput('pr_body', `${{ steps.resolve_pr.outputs.pr_body }}`);
-            core.setOutput('pr_url', '${{ steps.resolve_pr.outputs.pr_url }}');
+            core.setOutput('pr_title', process.env.PR_TITLE || '');
+            core.setOutput('pr_body', process.env.PR_BODY || '');
+            core.setOutput('pr_url', process.env.PR_URL || '');
             core.setOutput('pr_number', prNumber.toString());
             core.setOutput('approved_reviewers', approvedReviewers.join(','));
             core.setOutput('changed_files', changedFiles.join('\n'));
@@ -421,14 +427,19 @@ jobs:
       - name: Dry run summary
         if: steps.generate_draft.outputs.response != '' && inputs.dry_run == true
         uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        env:
+          PR_AUTHOR: ${{ steps.gather_context.outputs.pr_author }}
+          PR_URL: ${{ steps.gather_context.outputs.pr_url }}
+          PARENT_TITLE: ${{ steps.check_parent.outputs.parent_title }}
+          DRAFT: ${{ steps.generate_draft.outputs.response }}
         with:
           script: |
             core.info('=== DRY RUN — no PR will be created, no Slack DM sent ===');
-            core.info(`PR author: ${{ steps.gather_context.outputs.pr_author }}`);
-            core.info(`Source PR: ${{ steps.gather_context.outputs.pr_url }}`);
-            core.info(`Parent issue: ${{ steps.check_parent.outputs.parent_title }}`);
+            core.info(`PR author: ${process.env.PR_AUTHOR || ''}`);
+            core.info(`Source PR: ${process.env.PR_URL || ''}`);
+            core.info(`Parent issue: ${process.env.PARENT_TITLE || ''}`);
             core.info('--- Generated changelog draft ---');
-            core.info(`${{ steps.generate_draft.outputs.response }}`);
+            core.info((process.env.DRAFT || '').replace(/^::/gm, ': :'));
             core.info('--- End of draft ---');
 
       - name: Create changelog PR in docs-content

.github/workflows/changelog-agent.yml

@@ -44,5 +44,4 @@ jobs:
       - uses: ./.github/actions/slack-alert
         if: ${{ failure() && github.event_name != 'pull_request_target' }}
         with:
-          slack_channel_id: ${{ secrets.DOCS_ALERTS_SLACK_CHANNEL_ID }}
           slack_token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }}

.github/workflows/close-on-invalid-label.yaml

@@ -39,7 +39,6 @@ jobs:
       - uses: ./.github/actions/slack-alert
         if: ${{ failure() && github.event_name != 'pull_request' }}
         with:
-          slack_channel_id: ${{ secrets.DOCS_ALERTS_SLACK_CHANNEL_ID }}
           slack_token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }}
 
       - uses: ./.github/actions/create-workflow-failure-issue