Merge pull request #39670 from github/repo-sync

Repo sync

Author: docs-bot

.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"

assets/images/help/copilot/mermaid-gantt-chart-example.png

@@ -0,0 +1,13 @@
+---
+title: How-tos for your GitHub account and profile
+shortTitle: How-tos
+intro: 'Learn how to accomplish specific tasks for your {% data variables.product.github %} account and profile.'
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+children:
+  - /setting-up-and-managing-your-github-profile
+  - /setting-up-and-managing-your-personal-account-on-github
+---
+

content/account-and-profile/how-tos/index.md

@@ -4,6 +4,7 @@ intro: You can customize your profile so that other people can get a better sens
 redirect_from:
   - /articles/customizing-your-profile
   - /github/setting-up-and-managing-your-github-profile/customizing-your-profile
+  - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile
 versions:
   fpt: '*'
   ghes: '*'

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/index.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/index.md

@@ -11,6 +11,7 @@ permissions: 'Profile READMEs are not available to {% data variables.enterprise.
 redirect_from:
   - /github/setting-up-and-managing-your-github-profile/managing-your-profile-readme
   - /github/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme
+  - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme
 shortTitle: Your profile README
 ---
 ## About your profile README

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md

@@ -6,6 +6,7 @@ redirect_from:
   - /articles/pinning-items-to-your-profile
   - /github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile
   - /github/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile
+  - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile
 versions:
   fpt: '*'
   ghes: '*'

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile.md

@@ -6,6 +6,8 @@ versions:
 topics:
   - Profiles
 shortTitle: Set profile to private
+redirect_from:
+  - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private
 ---
 ## About private profiles
 

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md

@@ -5,6 +5,7 @@ shortTitle: Profiles
 redirect_from:
   - /categories/setting-up-and-managing-your-github-profile
   - /github/setting-up-and-managing-your-github-profile
+  - /account-and-profile/setting-up-and-managing-your-github-profile
 versions:
   fpt: '*'
   ghes: '*'

content/account-and-profile/setting-up-and-managing-your-github-profile/index.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/index.md

@@ -5,6 +5,7 @@ redirect_from:
   - /articles/managing-contribution-graphs-on-your-profile
   - /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile
   - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile
+  - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile
 versions:
   fpt: '*'
   ghes: '*'

content/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/index.md renamed to content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/index.md

@@ -9,6 +9,7 @@ redirect_from:
   - /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-your-github-enterprise-server-contributions-to-your-githubcom-profile
   - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile
   - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sending-enterprise-contributions-to-your-githubcom-profile
+  - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sharing-contributions-from-github-enterprise-server
 versions:
   fpt: '*'
   ghes: '*'