Merge branch 'main' into main

Author: Ebonsignori

.github/workflows/readability.yml

@@ -0,0 +1,108 @@
+name: Readability report
+
+# **What it does**: Analyzes readability of rendered content for changed Markdown files in pull requests
+# **Why we have it**: We want to track and improve the readability of our documentation over time
+# **Who does it impact**: Contributors and content writers
+
+on:
+  # pull_request:
+  #   paths:
+  #     - 'content/**/*.md'
+  #     - 'data/reusables/**/*.md'
+  # The pull_request trigger is currently disabled for testing purposes.
+  # Re-enable this trigger when ready to run readability analysis automatically on PRs.
+  workflow_dispatch:
+    inputs:
+      pull_request_number:
+        description: 'Pull request number to analyze (for testing)'
+        required: true
+        type: number
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  readability-analysis:
+    if: github.repository == 'github/docs-internal'
+    runs-on: ${{ fromJSON('["ubuntu-latest", "ubuntu-20.04-xl"]')[github.repository == 'github/docs-internal'] }}
+    steps:
+      - name: Check out repo with full history
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+
+      - name: Checkout PR for manual dispatch
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        run: |
+          gh pr checkout ${{ inputs.pull_request_number }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: ./.github/actions/node-npm-setup
+
+      - uses: ./.github/actions/get-docs-early-access
+        if: ${{ github.repository == 'github/docs-internal' }}
+        with:
+          token: ${{ secrets.DOCS_BOT_PAT_BASE }}
+
+      - name: Get changed content files
+        id: changed_files
+        uses: ./.github/actions/get-changed-files
+        with:
+          files: 'content/**/*.md'
+          # For workflow_dispatch, compare against main
+          base: ${{ github.event_name == 'workflow_dispatch' && 'main' || '' }}
+
+      - name: Disable Next.js telemetry
+        run: npx next telemetry disable
+
+      - name: Start server in the background
+        if: ${{ steps.changed_files.outputs.filtered_changed_files }}
+        run: npm start > /tmp/stdout.log 2> /tmp/stderr.log &
+
+      - name: Run readability analysis
+        if: ${{ steps.changed_files.outputs.filtered_changed_files }}
+        env:
+          CHANGED_FILES: ${{ steps.changed_files.outputs.filtered_changed_files }}
+        run: npm run readability-report
+
+      - name: Find existing readability comment
+        if: ${{ steps.changed_files.outputs.filtered_changed_files }}
+        uses: peter-evans/find-comment@3eae4d37986fb5a8592848f6a574fdf654e61f9e
+        id: findComment
+        with:
+          issue-number: ${{ github.event_name == 'workflow_dispatch' && inputs.pull_request_number || github.event.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: '<!-- READABILITY_REPORT -->'
+
+      - name: Read readability report
+        if: ${{ steps.changed_files.outputs.filtered_changed_files }}
+        id: read_report
+        run: |
+          if [ -f "readability-report.md" ]; then
+            {
+              echo 'report<<EOF'
+              cat readability-report.md
+              echo EOF
+            } >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create or update readability comment
+        if: ${{ steps.changed_files.outputs.filtered_changed_files && steps.read_report.outputs.report }}
+        uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043
+        with:
+          comment-id: ${{ steps.findComment.outputs.comment-id }}
+          issue-number: ${{ github.event_name == 'workflow_dispatch' && inputs.pull_request_number || github.event.number }}
+          body: |
+            <!-- READABILITY_REPORT -->
+            ${{ steps.read_report.outputs.report }}
+          edit-mode: replace
+
+      - if: ${{ failure() }}
+        name: Debug server outputs on errors
+        run: |
+          echo "____STDOUT____"
+          cat /tmp/stdout.log || echo "No stdout log found"
+          echo "____STDERR____"
+          cat /tmp/stderr.log || echo "No stderr log found"

.nvmrc

@@ -1,5 +1,21 @@
 # Docs changelog
 
+**4 August 2025**
+
+To address common pain points that developers face when remediating a leaked secret, we created a new article, "[Remediating a leaked secret](https://docs.github.com/en/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/remediating-a-leaked-secret)". 
+
+The new guide incorporates cross-platform GitHub tools, as well as opinionated guidance from GitHub's secret scanning team, to walk the developer through a thorough remediation process.
+
+It also clearly communicates the risks of leaked secrets, the challenges of remediation, and the value of enabling [GitHub Secret Protection](https://docs.github.com/en/get-started/learning-about-github/about-github-advanced-security#github-secret-protection).
+
+<hr>
+
+**28 July 2025**
+
+We have restructured the general "[Billing and payments](https://docs.github.com/en/billing)" articles to align with the Copilot and Actions docs. In addition, we've combined a few old "About" articles to directly answer common questions that new users have: [How GitHub billing works](https://docs.github.com/en/billing/get-started/how-billing-works) and [Introduction to billing and licensing](https://docs.github.com/en/billing/get-started/introduction-to-billing).
+
+<hr>
+
 **16 July 2025**
 
 We've added documentation describing how to use the GraphQL API to create a new issue and, in the same request, assign the issue to Copilot coding agent.
@@ -75,7 +91,7 @@ See [About Billing for GitHub Models](https://docs.github.com/billing/managing-b
 
 **23 June 2025**
 
-We’ve restructured our documentation around Copilot’s AI models to make it easier for users to understand, choose, and configure models across clients and plans. See [Supported AI models in Copilot](https://docs.github.com/copilot/using-github-copilot/ai-models/supported-ai-models-in-copilot) and [Choosing the right AI model for your task](https://docs.github.com/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task).
+We’ve restructured our documentation around Copilot’s AI models to make it easier for users to understand, choose, and configure models across clients and plans. See [Supported AI models in Copilot](https://docs.github.com/copilot/using-github-copilot/ai-models/supported-ai-models-in-copilot) and [Choosing the right AI model for your task](https://docs.github.com/copilot/reference/ai-models/model-comparison).
 
 <hr>
 

CHANGELOG.md

@@ -8,7 +8,7 @@
 # ---------------------------------------------------------------
 # To update the sha:
 # https://github.com/github/gh-base-image/pkgs/container/gh-base-image%2Fgh-base-noble
-FROM ghcr.io/github/gh-base-image/gh-base-noble:20250715-152201-gef17a3886 AS base
+FROM ghcr.io/github/gh-base-image/gh-base-noble:20250805-204228-g50c20871f AS base
 
 # Install curl for Node install and determining the early access branch
 # Install git for cloning docs-early-access & translations repos