Merge branch 'main' into intel_macos14

Author: tqpcharlie

.devcontainer/devcontainer.json

@@ -15,7 +15,8 @@
     "ghcr.io/devcontainers/features/copilot-cli:1": {
       "version": "prerelease"
     },
-    "ghcr.io/devcontainers/features/github-cli:1": {}
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {}
   },
 
   "customizations": {

.gitattributes

@@ -1,6 +1,7 @@
 # Set default behavior, in case users don't have core.autocrlf set.
 * text=auto
-# Explicitly declare text files we want to always be normalized and converted
-# to native line endings on checkout.
-*.md text diff=markdown
+# Explicitly declare text files we want to always be normalized, and for
+# Markdown files, enforce LF line endings on checkout.
+*.md text eol=lf diff=markdown
 *.json.br filter=lfs diff=lfs merge=lfs -text
+.github/workflows/*.lock.yml linguist-generated=true merge=ours

.github/actions/create-workflow-failure-issue/action.yml

@@ -0,0 +1,93 @@
+name: Create workflow failure issue
+description: Create or update a GitHub issue in docs-engineering when a workflow fails, for automated diagnosis by an agentic workflow.
+
+inputs:
+  token:
+    description: A token with issues write permission on the target repo
+    required: true
+  repo:
+    description: The repository to create the issue in
+    default: github/docs-engineering
+    required: false
+
+runs:
+  using: composite
+  steps:
+    - name: Check for existing open issue
+      id: check-existing
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.token }}
+        ISSUE_REPO: ${{ inputs.repo }}
+        WORKFLOW_NAME: ${{ github.workflow }}
+      run: |
+        existing=$(gh issue list \
+          --repo "$ISSUE_REPO" \
+          --label "workflow-failure" \
+          --search "in:title [Workflow Failure] $WORKFLOW_NAME" \
+          --state open \
+          --json number \
+          --jq '.[0].number // empty' 2>/dev/null || true)
+        echo "existing_issue=$existing" >> "$GITHUB_OUTPUT"
+
+    - name: Comment on existing issue
+      if: steps.check-existing.outputs.existing_issue != ''
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.token }}
+        ISSUE_REPO: ${{ inputs.repo }}
+        ISSUE_NUMBER: ${{ steps.check-existing.outputs.existing_issue }}
+        WORKFLOW_NAME: ${{ github.workflow }}
+        SOURCE_REPO: ${{ github.repository }}
+        RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        EVENT_NAME: ${{ github.event_name }}
+        GIT_REF: ${{ github.ref }}
+      run: |
+        body=$(cat <<EOF
+        ### Repeat failure
+
+        **Workflow:** \`$WORKFLOW_NAME\`
+        **Repository:** \`$SOURCE_REPO\`
+        **Run:** $RUN_URL
+        **Event:** \`$EVENT_NAME\`
+        **Ref:** \`$GIT_REF\`
+        **Timestamp:** $(date -u +%Y-%m-%dT%H:%M:%SZ)
+        EOF
+        )
+        gh issue comment "$ISSUE_NUMBER" \
+          --repo "$ISSUE_REPO" \
+          --body "$body"
+
+    - name: Create workflow failure issue
+      if: steps.check-existing.outputs.existing_issue == ''
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.token }}
+        ISSUE_REPO: ${{ inputs.repo }}
+        WORKFLOW_NAME: ${{ github.workflow }}
+        SOURCE_REPO: ${{ github.repository }}
+        RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        EVENT_NAME: ${{ github.event_name }}
+        GIT_REF: ${{ github.ref }}
+        ACTOR: ${{ github.actor }}
+      run: |
+        body=$(cat <<EOF
+        ### Workflow failure
+
+        **Workflow:** \`$WORKFLOW_NAME\`
+        **Repository:** \`$SOURCE_REPO\`
+        **Run:** $RUN_URL
+        **Event:** \`$EVENT_NAME\`
+        **Ref:** \`$GIT_REF\`
+        **Triggered by:** \`$ACTOR\`
+        **Timestamp:** $(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+        ---
+        This issue was automatically created by the create-workflow-failure-issue action to enable automated diagnosis.
+        EOF
+        )
+        gh issue create \
+          --repo "$ISSUE_REPO" \
+          --label "workflow-failure" \
+          --title "[Workflow Failure] $WORKFLOW_NAME" \
+          --body "$body"

.github/actions/get-changed-files/action.yml

@@ -0,0 +1,22 @@
+# Copilot instructions for docs.github.com
+
+This repository powers the GitHub Docs site (docs.github.com). It contains both the Next.js application code (TypeScript) and the documentation content (Markdown).
+
+## Instruction files
+
+Read the relevant instruction files in `.github/instructions/` before making changes:
+
+* **`all.instructions.md`** — General project guidelines, PR conventions, and how to access docs.github.com content programmatically. Applies to all files.
+* **`code.instructions.md`** — TypeScript/JavaScript coding standards, test commands (per-suite with environment variables), and validation steps. Read this before any code change.
+* **`content.instructions.md`** — Markdown content conventions, Liquid variable usage, reusables, and linking with `[AUTOTITLE]`. Read this before any content change.
+* **`style-guide-summary.instructions.md`** — Condensed docs style guide covering voice, headers, lists, alerts, and formatting. Read this before any content change.
+
+## Key rules
+
+* All new code must be TypeScript (not JavaScript).
+* Use `@/` absolute imports (e.g., `import getRedirect from '@/redirects/lib/get-redirect'`).
+* Do not run `npm test` without a path argument — always target a specific suite.
+* Run `npm run build` before running tests.
+* Do not commit to `main`. Create a branch and open a draft PR.
+* Use Liquid variables for product names — never hardcode them. Check `data/variables/`.
+* Use `[AUTOTITLE](/path/to/article)` for internal links — never hardcode article titles.