Skip to content

Repo sync #39670

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Aug 5, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
c4f3330
Merge pull request #56972 from github/repo-sync
docs-bot Aug 4, 2025
4fd5b55
Sync secret scanning data (#56966)
docs-bot Aug 4, 2025
e0c42df
[EDI] Add how-tos category for account and profile docs (re-do) (#56974)
jc-clark Aug 4, 2025
a0a56cb
Revise AI model capabilities in comparison table (#56867)
thispaul Aug 5, 2025
75349e6
Extending closing down dates for GHES 3.14 through 3.17 (#56975)
pallsama Aug 5, 2025
7e44265
Providing answers to some obvious questions customers may have due to…
pallsama Aug 5, 2025
f13d84e
Remove outdated note about feature status and update prerequisite ins…
houghj16 Aug 5, 2025
21a3dea
Update 2FA recovery language post-UX changes (#56832)
joshuawalker Aug 5, 2025
d200b47
Add excluded link for github-early-access (#56921)
guntrip Aug 5, 2025
f9fc809
Get Copilot to help create a readability assessment (#56967)
felicitymay Aug 5, 2025
a7e37b6
Enhanced permissions for spaces: teams, users, and write permissions …
isaacmbrown Aug 5, 2025
733587a
Cookbook article on using Chat to create diagrams (#56907)
jules-p Aug 5, 2025
3114c08
Merge remote-tracking branch 'public/main'
rsese Aug 5, 2025
2548f7d
[EDI] Create new "Subscriptions and notifications" landing page and g…
jc-clark Aug 5, 2025
7191eae
GraphQL schema update (#56994)
docs-bot Aug 5, 2025
27b51c8
08-05-25 Tented model (#56985)
sunbrye Aug 5, 2025
8ecf8c9
Update audit log event data (#56995)
docs-bot Aug 5, 2025
07af0c1
Rename REST content-type utilities to code-example-utils (#56894)
rsese Aug 5, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
108 changes: 108 additions & 0 deletions .github/workflows/readability.yml
Original file line number Diff line number Diff line change
@@ -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"
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 13 additions & 0 deletions content/account-and-profile/how-tos/index.md
Original file line number Diff line number Diff line change
@@ -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
---

Original file line number Diff line number Diff line change
Expand Up @@ -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: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-profile/showing-an-overview-of-your-activity-on-your-profile
- /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/showing-an-overview-of-your-activity-on-your-profile
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/showing-an-overview-of-your-activity-on-your-profile
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-an-overview-of-your-activity-on-your-profile
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
@@ -1,18 +1,19 @@
---
title: Showing your private contributions {% ifversion hide-individual-achievements %}and achievements {% endif %}on your profile
intro: 'Your profile shows a graph of your repository contributions over the past year. You can choose to show anonymized activity from private and internal repositories in addition to the activity from public repositories.'
title: 'Showing your private contributions {% ifversion hide-individual-achievements %}and achievements {% endif %}on your profile'
intro: Your profile shows a graph of your repository contributions over the past year. You can choose to show anonymized activity from private and internal repositories in addition to the activity from public repositories.
redirect_from:
- /articles/publicizing-or-hiding-your-private-contributions-on-your-profile
- /github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile
- /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/publicizing-or-hiding-your-private-contributions-on-your-profile
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile
versions:
fpt: '*'
ghes: '*'
ghec: '*'
topics:
- Profiles
shortTitle: Private contributions {% ifversion hide-individual-achievements %}and achievements{% endif %}
shortTitle: 'Private contributions {% ifversion hide-individual-achievements %}and achievements{% endif %}'
allowTitleToDifferFromFilename: true
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-profile/troubleshooting-commits-on-your-timeline
- /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/troubleshooting-commits-on-your-timeline
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/troubleshooting-commits-on-your-timeline
- /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-commits-on-your-timeline
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /categories/setting-up-and-managing-your-github-user-account
- /github/setting-up-and-managing-your-github-user-account
- /account-and-profile/setting-up-and-managing-your-github-user-account
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github
versions:
fpt: '*'
ghes: '*'
Expand All @@ -19,3 +20,4 @@ children:
- /managing-access-to-your-personal-repositories
- /managing-your-membership-in-organizations
---

Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ redirect_from:
- /articles/managing-access-to-your-personal-repositories
- /github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories
product: '{% data reusables.gated-features.user-repo-collaborators %}'
versions:
fpt: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository
- /github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository
product: '{% data reusables.gated-features.user-repo-collaborators %}'
versions:
fpt: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/maintaining-ownership-continuity-of-your-user-accounts-repositories
- /github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-user-accounts-repositories
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-user-accounts-repositories
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-personal-accounts-repositories
shortTitle: Ownership continuity
---
## About successors
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/removing-a-collaborator-from-a-personal-repository
- /github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository
product: '{% data reusables.gated-features.user-repo-collaborators %}'
versions:
fpt: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository
- /github/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/adding-an-email-address-to-your-github-account
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/adding-an-email-address-to-your-github-account
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/adding-an-email-address-to-your-github-account
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/blocking-command-line-pushes-that-expose-your-personal-email-address
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address
versions:
fpt: '*'
ghec: '*'
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
title: Changing your primary email address
intro: To change your primary email address, you'll add a new email, then delete the old one.
intro: 'To change your primary email address, you''ll add a new email, then delete the old one.'
redirect_from:
- /articles/changing-your-primary-email-address
- /github/setting-up-and-managing-your-github-user-account/changing-your-primary-email-address
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/changing-your-primary-email-address
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/changing-your-primary-email-address
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /articles/managing-email-preferences
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/managing-marketing-emails-from-github
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/managing-marketing-emails-from-github
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/managing-marketing-emails-from-github
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/managing-marketing-emails-from-github
versions:
fpt: '*'
ghec: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/remembering-your-github-username-or-email
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/remembering-your-github-username-or-email
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/remembering-your-github-username-or-email
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/remembering-your-github-username-or-email
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
title: Setting a backup email address
intro: 'Use a backup email address as an additional destination for security-relevant account notifications and to securely reset your password if you can no longer access your primary email address.'
intro: Use a backup email address as an additional destination for security-relevant account notifications and to securely reset your password if you can no longer access your primary email address.
redirect_from:
- /articles/setting-a-backup-email-address
- /github/setting-up-and-managing-your-github-user-account/setting-a-backup-email-address
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-a-backup-email-address
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-a-backup-email-address
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-a-backup-email-address
versions:
fpt: '*'
ghes: '*'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ redirect_from:
- /github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address
- /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-your-commit-email-address
- /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/setting-your-commit-email-address
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address
versions:
fpt: '*'
ghes: '*'
Expand Down
Loading
Loading