From 0d415645a9c7de12347e8b45f778138e6d5e172d Mon Sep 17 00:00:00 2001 From: Joe Clark <31087804+jc-clark@users.noreply.github.com> Date: Fri, 17 Oct 2025 11:38:12 -0700 Subject: [PATCH 1/4] [EDI] Account and profile category/map topic cleanup (#57850) Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com> --- ...nt-management.md => account-management.md} | 5 ++- ...le.md => contributions-on-your-profile.md} | 9 +++-- .../concepts/email-addresses.md | 3 +- content/account-and-profile/concepts/index.md | 13 ++++--- ...mbership.md => organization-membership.md} | 2 ++ ...ons-profile.md => organization-profile.md} | 5 ++- ...ut-your-profile.md => personal-profile.md} | 5 +-- .../get-started/account.md | 34 +++++++++++++++++++ .../account-and-profile/get-started/index.md | 2 ++ .../personal-dashboard-quickstart.md | 1 + .../get-started/profile.md | 3 +- .../changing-your-username.md | 5 ++- .../converting-a-user-into-an-organization.md | 4 ++- .../deleting-your-personal-account.md | 8 ++++- .../index.md | 6 ++-- .../managing-multiple-accounts.md | 8 ++++- .../merging-multiple-personal-accounts.md | 4 ++- ...our-email-address-from-a-locked-account.md | 4 ++- .../index.md | 4 ++- ...rating-jira-with-your-personal-projects.md | 9 +++-- .../manage-cookie-preferences.md | 5 +++ ...o-your-personal-accounts-project-boards.md | 12 +++++-- .../managing-accessibility-settings.md | 7 +++- ...managing-security-and-analysis-features.md | 3 +- ...ging-your-tab-size-rendering-preference.md | 6 ++++ ...oject-board-owned-by-a-personal-account.md | 8 +++-- .../prepare-for-job-change.md | 1 + .../set-your-hiring-status.md | 1 + .../index.md | 4 ++- ...-private-contributions-and-achievements.md | 1 + ...ributions-from-github-enterprise-server.md | 4 ++- ...erview-of-your-activity-on-your-profile.md | 2 ++ .../troubleshooting-missing-contributions.md | 1 + ...ewing-commit-details-from-your-timeline.md | 1 + .../viewing-contributions-on-your-profile.md | 2 ++ ...an-email-address-to-your-github-account.md | 8 +++-- ...that-expose-your-personal-email-address.md | 8 ++++- .../changing-your-primary-email-address.md | 8 ++++- .../index.md | 4 ++- ...membering-your-github-username-or-email.md | 4 ++- .../setting-a-backup-email-address.md | 9 ++--- .../setting-your-commit-email-address.md | 6 +++- .../troubleshooting-adding-an-email.md | 9 ++++- .../troubleshooting-email-verification.md | 11 ++++-- .../verifying-your-email-address.md | 6 +++- content/account-and-profile/how-tos/index.md | 21 ++++++++++-- .../accessing-an-organization.md | 4 ++- .../index.md | 7 ++-- ...izing-or-hiding-organization-membership.md | 4 ++- .../removing-yourself-from-an-organization.md | 4 ++- ...ng-organization-approval-for-oauth-apps.md | 6 ++-- ...iewing-peoples-roles-in-an-organization.md | 4 ++- .../index.md | 3 ++ .../managing-your-profile-readme.md | 6 ++-- .../pinning-items-to-your-profile.md | 2 ++ .../setting-your-profile-to-private.md | 4 ++- .../index.md | 19 ----------- .../index.md | 23 ------------- content/account-and-profile/index.md | 13 +++---- .../reference/email-addresses-reference.md | 3 +- .../account-and-profile/reference/index.md | 3 +- .../reference/personal-account-reference.md | 3 +- .../reference/personal-dashboard.md | 3 +- .../profile-contributions-reference.md | 3 +- .../reference/profile-reference.md | 3 +- .../reference/username-reference.md | 3 +- .../account-and-profile/tutorials/index.md | 1 + ...r-github-profile-to-enhance-your-resume.md | 3 +- .../access-to-repositories.md} | 6 +++- .../index.md | 4 ++- .../index.md | 4 ++- .../index.md | 5 ++- ...-collaborators-to-a-personal-repository.md | 4 ++- ...-of-your-personal-accounts-repositories.md | 2 ++ ...evels-for-a-personal-account-repository.md | 2 ++ ...collaborator-from-a-personal-repository.md | 4 ++- ...ourself-from-a-collaborators-repository.md | 8 ++++- .../concepts/index.md | 3 +- .../concepts/scheduled-reminders.md | 5 ++- .../how-tos/index.md | 3 +- .../managing-your-scheduled-reminders.md | 2 ++ .../reference/index.md | 4 ++- .../reference/types-of-emails-github-sends.md | 4 ++- 83 files changed, 333 insertions(+), 137 deletions(-) rename content/account-and-profile/concepts/{personal-account-management.md => account-management.md} (97%) rename content/account-and-profile/concepts/{contributions-visible-on-your-profile.md => contributions-on-your-profile.md} (92%) rename content/account-and-profile/concepts/{about-organization-membership.md => organization-membership.md} (97%) rename content/account-and-profile/concepts/{about-your-organizations-profile.md => organization-profile.md} (91%) rename content/account-and-profile/concepts/{about-your-profile.md => personal-profile.md} (95%) create mode 100644 content/account-and-profile/get-started/account.md rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/changing-your-username.md (86%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/converting-a-user-into-an-organization.md (95%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/deleting-your-personal-account.md (86%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/index.md (54%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/managing-multiple-accounts.md (90%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/merging-multiple-personal-accounts.md (91%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account => account-management}/unlinking-your-email-address-from-a-locked-account.md (80%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/index.md (87%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/integrating-jira-with-your-personal-projects.md (77%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/manage-cookie-preferences.md (88%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/managing-access-to-your-personal-accounts-project-boards.md (80%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/managing-accessibility-settings.md (92%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/managing-security-and-analysis-features.md (93%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/managing-your-tab-size-rendering-preference.md (79%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/permission-levels-for-a-project-board-owned-by-a-personal-account.md (91%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/prepare-for-job-change.md (97%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings => account-settings}/set-your-hiring-status.md (91%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/index.md (85%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/manage-visibility-settings-for-private-contributions-and-achievements.md (93%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/sharing-contributions-from-github-enterprise-server.md (89%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/showing-an-overview-of-your-activity-on-your-profile.md (88%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/troubleshooting-missing-contributions.md (97%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/viewing-commit-details-from-your-timeline.md (95%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile => contribution-settings}/viewing-contributions-on-your-profile.md (94%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/adding-an-email-address-to-your-github-account.md (79%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/blocking-command-line-pushes-that-expose-your-personal-email-address.md (74%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/changing-your-primary-email-address.md (83%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/index.md (86%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/remembering-your-github-username-or-email.md (90%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/setting-a-backup-email-address.md (77%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/setting-your-commit-email-address.md (89%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/troubleshooting-adding-an-email.md (83%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/troubleshooting-email-verification.md (77%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-email-preferences => email-preferences}/verifying-your-email-address.md (74%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/accessing-an-organization.md (79%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/index.md (68%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/publicizing-or-hiding-organization-membership.md (82%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/removing-yourself-from-an-organization.md (84%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/requesting-organization-approval-for-oauth-apps.md (86%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => organization-membership}/viewing-peoples-roles-in-an-organization.md (90%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/customizing-your-profile => profile-customization}/index.md (78%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/customizing-your-profile => profile-customization}/managing-your-profile-readme.md (86%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/customizing-your-profile => profile-customization}/pinning-items-to-your-profile.md (92%) rename content/account-and-profile/how-tos/{setting-up-and-managing-your-github-profile/customizing-your-profile => profile-customization}/setting-your-profile-to-private.md (78%) delete mode 100644 content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/index.md delete mode 100644 content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/index.md rename content/{account-and-profile/concepts/personal-repository-access-and-collaboration.md => repositories/creating-and-managing-repositories/access-to-repositories.md} (87%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/index.md (80%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/inviting-collaborators-to-a-personal-repository.md (87%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md (88%) rename content/{account-and-profile/reference => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/permission-levels-for-a-personal-account-repository.md (99%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/removing-a-collaborator-from-a-personal-repository.md (86%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories => repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration}/removing-yourself-from-a-collaborators-repository.md (72%) rename content/{account-and-profile => subscriptions-and-notifications}/concepts/scheduled-reminders.md (88%) rename content/{account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations => subscriptions-and-notifications/how-tos}/managing-your-scheduled-reminders.md (94%) rename content/{account-and-profile => subscriptions-and-notifications}/reference/types-of-emails-github-sends.md (90%) diff --git a/content/account-and-profile/concepts/personal-account-management.md b/content/account-and-profile/concepts/account-management.md similarity index 97% rename from content/account-and-profile/concepts/personal-account-management.md rename to content/account-and-profile/concepts/account-management.md index 4e936c3bcbae..1a10f571cef2 100644 --- a/content/account-and-profile/concepts/personal-account-management.md +++ b/content/account-and-profile/concepts/account-management.md @@ -1,6 +1,6 @@ --- title: Personal account management -intro: 'Learn how to manage your personal account on {% data variables.location.product_location %}.' +intro: Learn how to manage your personal account on {% data variables.location.product_location %}. versions: fpt: '*' ghes: '*' @@ -8,6 +8,9 @@ versions: topics: - Accounts shortTitle: Account management +contentType: concepts +redirect_from: + - /account-and-profile/concepts/personal-account-management --- ## About converting your personal account diff --git a/content/account-and-profile/concepts/contributions-visible-on-your-profile.md b/content/account-and-profile/concepts/contributions-on-your-profile.md similarity index 92% rename from content/account-and-profile/concepts/contributions-visible-on-your-profile.md rename to content/account-and-profile/concepts/contributions-on-your-profile.md index fbe628132f83..3ace61290d10 100644 --- a/content/account-and-profile/concepts/contributions-visible-on-your-profile.md +++ b/content/account-and-profile/concepts/contributions-on-your-profile.md @@ -1,13 +1,16 @@ --- -title: Contributions visible on your profile -intro: 'Your profile shows off your pinned repositories, Achievements, and a graph of your repository contributions over the past year.' +title: Contributions on your profile +intro: Your profile shows off your pinned repositories, Achievements, and a graph of your repository contributions over the past year. versions: fpt: '*' ghes: '*' ghec: '*' topics: - Profiles -shortTitle: Contributions on your profile +shortTitle: Profile contributions +contentType: concepts +redirect_from: + - /account-and-profile/concepts/contributions-visible-on-your-profile --- ## About your contribution graph diff --git a/content/account-and-profile/concepts/email-addresses.md b/content/account-and-profile/concepts/email-addresses.md index 5d42716960ce..79f18cd9dd6c 100644 --- a/content/account-and-profile/concepts/email-addresses.md +++ b/content/account-and-profile/concepts/email-addresses.md @@ -1,6 +1,6 @@ --- title: Email addresses -intro: 'Learn about the different types of email addresses you can associate with your {% data variables.product.github %} account—primary, backup, commit, and noreply—and how each type is used for account management, security, and commit attribution.' +intro: Learn about the different types of email addresses you can associate with your {% data variables.product.github %} account—primary, backup, commit, and noreply—and how each type is used for account management, security, and commit attribution. versions: fpt: '*' ghes: '*' @@ -10,6 +10,7 @@ topics: - Fundamentals - Profile shortTitle: Email addresses +contentType: concepts --- ## Adding an email address to your {% data variables.product.github %} account diff --git a/content/account-and-profile/concepts/index.md b/content/account-and-profile/concepts/index.md index 5ceb7ce08513..885674d87a23 100644 --- a/content/account-and-profile/concepts/index.md +++ b/content/account-and-profile/concepts/index.md @@ -10,14 +10,13 @@ topics: - Accounts - Profiles children: - - /about-your-profile - - /personal-account-management - - /contributions-visible-on-your-profile - - /about-your-organizations-profile - - /about-organization-membership + - /personal-profile + - /account-management - /username-changes - /email-addresses - - /scheduled-reminders - - /personal-repository-access-and-collaboration + - /contributions-on-your-profile + - /organization-membership + - /organization-profile +contentType: concepts --- diff --git a/content/account-and-profile/concepts/about-organization-membership.md b/content/account-and-profile/concepts/organization-membership.md similarity index 97% rename from content/account-and-profile/concepts/about-organization-membership.md rename to content/account-and-profile/concepts/organization-membership.md index c102a38c0bad..ed1859fc2f8a 100644 --- a/content/account-and-profile/concepts/about-organization-membership.md +++ b/content/account-and-profile/concepts/organization-membership.md @@ -7,6 +7,7 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/about-organization-membership - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/about-organization-membership - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/about-organization-membership + - /account-and-profile/concepts/about-organization-membership versions: fpt: '*' ghes: '*' @@ -14,6 +15,7 @@ versions: topics: - Accounts shortTitle: Organization membership +contentType: concepts --- An organization owner can invite you to join their organization as a member, billing manager, or owner. An organization owner or member with admin privileges for a repository can invite you to collaborate in one or more repositories as an outside collaborator. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization). diff --git a/content/account-and-profile/concepts/about-your-organizations-profile.md b/content/account-and-profile/concepts/organization-profile.md similarity index 91% rename from content/account-and-profile/concepts/about-your-organizations-profile.md rename to content/account-and-profile/concepts/organization-profile.md index 178bf592472b..28fe40b53aeb 100644 --- a/content/account-and-profile/concepts/about-your-organizations-profile.md +++ b/content/account-and-profile/concepts/organization-profile.md @@ -1,5 +1,5 @@ --- -title: About your organization's profile +title: Your organization's profile intro: Your organization's profile page shows basic information about your organization. redirect_from: - /articles/about-your-organization-s-profile @@ -7,6 +7,8 @@ redirect_from: - /github/setting-up-and-managing-your-github-profile/about-your-organizations-profile - /github/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile + - /account-and-profile/concepts/about-your-organizations-profile + - /account-and-profile/concepts/organizations-profile versions: fpt: '*' ghes: '*' @@ -14,6 +16,7 @@ versions: topics: - Profiles shortTitle: Organization profile +contentType: concepts --- You can customize your organization's profile by adding any of the following: diff --git a/content/account-and-profile/concepts/about-your-profile.md b/content/account-and-profile/concepts/personal-profile.md similarity index 95% rename from content/account-and-profile/concepts/about-your-profile.md rename to content/account-and-profile/concepts/personal-profile.md index 006059338bd0..046c8c4fa20b 100644 --- a/content/account-and-profile/concepts/about-your-profile.md +++ b/content/account-and-profile/concepts/personal-profile.md @@ -1,7 +1,7 @@ --- title: About your profile shortTitle: Personal profile -intro: 'Your {% data variables.product.github %} profile showcases your work, contributions, and information you choose to share publicly.' +intro: Your {% data variables.product.github %} profile showcases your work, contributions, and information you choose to share publicly. redirect_from: - /articles/viewing-your-feeds - /articles/profile-pages @@ -9,15 +9,16 @@ redirect_from: - /github/setting-up-and-managing-your-github-profile/about-your-profile - /github/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-profile - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-profile + - /account-and-profile/concepts/about-your-profile versions: fpt: '*' ghes: '*' ghec: '*' topics: - Profiles +contentType: concepts --- - Your {% data variables.product.github %} profile showcases your work, contributions, and information you choose to share publicly. {% data reusables.profile.profile-visibility %} diff --git a/content/account-and-profile/get-started/account.md b/content/account-and-profile/get-started/account.md new file mode 100644 index 000000000000..0f4b29cc83a3 --- /dev/null +++ b/content/account-and-profile/get-started/account.md @@ -0,0 +1,34 @@ +--- +title: Account +intro: Get started with your {% data variables.product.github %} account. +versions: + fpt: '*' + ghes: '*' + ghec: '*' +topics: + - Accounts +shortTitle: Account +contentType: get-started +--- + +## About your {% data variables.product.github %} account + +Your account is the foundation of your {% data variables.product.github %} identity. It controls your access to repositories, organizations, and {% data variables.product.github %} features, and manages your personal settings and preferences. + +{% ifversion ghec %} + +## About {% data variables.enterprise.prodname_managed_users %} + +If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, your account is a {% data variables.enterprise.prodname_managed_user %}. {% data variables.enterprise.prodname_managed_users_caps %} are provisioned and managed by your enterprise through your identity provider. These accounts have different capabilities and restrictions compared to standard personal accounts. + +{% endif %} + +## Next steps + +* For conceptual information about accounts, see [AUTOTITLE](/account-and-profile/concepts/personal-account-management). +* For information about managing your account, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github). +* For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). +{%- ifversion ghec %} +* For information about {% data variables.enterprise.prodname_managed_users %}, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users). +* For information about managing multiple accounts, see [AUTOTITLE](/account-and-profile/concepts/personal-account-management#about-management-of-multiple-accounts). +{%- endif %} diff --git a/content/account-and-profile/get-started/index.md b/content/account-and-profile/get-started/index.md index 35283ff30799..f2b65eac7820 100644 --- a/content/account-and-profile/get-started/index.md +++ b/content/account-and-profile/get-started/index.md @@ -7,7 +7,9 @@ versions: ghes: '*' ghec: '*' children: + - /account - /profile - /personal-dashboard-quickstart +contentType: get-started --- diff --git a/content/account-and-profile/get-started/personal-dashboard-quickstart.md b/content/account-and-profile/get-started/personal-dashboard-quickstart.md index 1989d8dd4fd5..c4ce777a5430 100644 --- a/content/account-and-profile/get-started/personal-dashboard-quickstart.md +++ b/content/account-and-profile/get-started/personal-dashboard-quickstart.md @@ -18,6 +18,7 @@ versions: topics: - Accounts shortTitle: Personal dashboard quickstart +contentType: get-started --- ## Accessing your personal dashboard diff --git a/content/account-and-profile/get-started/profile.md b/content/account-and-profile/get-started/profile.md index e659dcca837a..81b161f178d1 100644 --- a/content/account-and-profile/get-started/profile.md +++ b/content/account-and-profile/get-started/profile.md @@ -1,6 +1,6 @@ --- title: Profile -intro: 'Get started with your {% data variables.product.github %} profile.' +intro: Get started with your {% data variables.product.github %} profile. versions: fpt: '*' ghes: '*' @@ -8,6 +8,7 @@ versions: topics: - Profiles shortTitle: Profile +contentType: get-started --- ## About your {% data variables.product.github %} profile diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username.md b/content/account-and-profile/how-tos/account-management/changing-your-username.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username.md rename to content/account-and-profile/how-tos/account-management/changing-your-username.md index 3608a7cc5fd9..42f42d981f92 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username.md +++ b/content/account-and-profile/how-tos/account-management/changing-your-username.md @@ -1,6 +1,6 @@ --- title: Changing your username -intro: 'Change your {% data variables.product.github %} username.' +intro: Change your {% data variables.product.github %} username. versions: fpt: '*' ghes: '*' @@ -10,6 +10,9 @@ topics: - Usernames shortTitle: Change username permissions: '{% ifversion ghec %}Users with personal accounts can change their username. Members of an {% data variables.enterprise.prodname_emu_enterprise %} cannot change their username.{% elsif ghes %}If your instance uses built-in authentication or LDAP, you can change your username. If you sign in to {% data variables.location.product_location %} with single sign-on (SSO), only your local administrator can change your username.{% else %}Users with personal accounts can change their username.{% endif %}' +contentType: how-tos +redirect_from: + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username --- ## Prerequisites diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/converting-a-user-into-an-organization.md b/content/account-and-profile/how-tos/account-management/converting-a-user-into-an-organization.md similarity index 95% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/converting-a-user-into-an-organization.md rename to content/account-and-profile/how-tos/account-management/converting-a-user-into-an-organization.md index 1496978a220b..3528a48d83ff 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/converting-a-user-into-an-organization.md +++ b/content/account-and-profile/how-tos/account-management/converting-a-user-into-an-organization.md @@ -9,6 +9,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/converting-a-user-into-an-organization - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/converting-a-user-into-an-organization - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/converting-a-user-into-an-organization + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/converting-a-user-into-an-organization intro: You can convert your personal account into an organization. This allows more granular permissions for repositories that belong to the organization. versions: fpt: '*' @@ -16,7 +17,8 @@ versions: ghec: '*' topics: - Accounts -shortTitle: User into an organization +shortTitle: Convert your account +contentType: how-tos --- ## Prerequisites diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account.md b/content/account-and-profile/how-tos/account-management/deleting-your-personal-account.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account.md rename to content/account-and-profile/how-tos/account-management/deleting-your-personal-account.md index 8f5a5d6ed207..43973e2dc2ff 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account.md +++ b/content/account-and-profile/how-tos/account-management/deleting-your-personal-account.md @@ -1,6 +1,6 @@ --- title: Deleting your personal account -intro: 'You can delete your personal account on {% data variables.location.product_location %} at any time.' +intro: You can delete your personal account on {% data variables.location.product_location %} at any time. redirect_from: - /articles/deleting-a-user-account - /articles/deleting-your-user-account @@ -9,6 +9,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/deleting-your-user-account - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/deleting-your-personal-account - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account versions: fpt: '*' ghes: '*' @@ -16,6 +17,7 @@ versions: topics: - Accounts shortTitle: Delete your account +contentType: how-tos --- {% ifversion ghec %} @@ -50,3 +52,7 @@ Before you delete your personal account, make a copy of all repositories, privat 1. In the "Make sure you want to do this" dialog box, complete the steps to confirm you understand what happens when your account is deleted: * In the first field, type your username or email. * In the second field, type the phrase from the prompt. + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/index.md b/content/account-and-profile/how-tos/account-management/index.md similarity index 54% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/index.md rename to content/account-and-profile/how-tos/account-management/index.md index 170004ba71d4..64b0125a06ab 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/index.md +++ b/content/account-and-profile/how-tos/account-management/index.md @@ -1,7 +1,7 @@ --- title: Managing your personal account -intro: 'You can manage your personal account on {% data variables.product.github %}. For example, you can {% ifversion fpt or ghec %}manage multiple accounts, {% endif %}convert an account to an organization, or delete an account.' -shortTitle: Manage personal account +intro: You can manage your personal account on {% data variables.product.github %}. For example, you can {% ifversion fpt or ghec %}manage multiple accounts, {% endif %}convert an account to an organization, or delete an account. +shortTitle: Personal account management versions: fpt: '*' ghes: '*' @@ -17,5 +17,7 @@ children: - /deleting-your-personal-account redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts.md b/content/account-and-profile/how-tos/account-management/managing-multiple-accounts.md similarity index 90% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts.md rename to content/account-and-profile/how-tos/account-management/managing-multiple-accounts.md index 611e189dc91c..16e34ca99d2f 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts.md +++ b/content/account-and-profile/how-tos/account-management/managing-multiple-accounts.md @@ -1,6 +1,6 @@ --- title: Managing multiple accounts -intro: 'If you use one workstation to contribute to projects for more than one account, you can modify your Git configuration to simplify the contribution process.' +intro: If you use one workstation to contribute to projects for more than one account, you can modify your Git configuration to simplify the contribution process. versions: feature: multiple-accounts-one-workstation topics: @@ -10,6 +10,8 @@ topics: shortTitle: Manage multiple accounts redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts +contentType: how-tos --- ## Contributing to multiple accounts using HTTPS and {% data variables.product.pat_generic %}s @@ -98,3 +100,7 @@ For example, the following command sets the `GIT_SSH_COMMAND` environment variab ```shell copy GIT_SSH_COMMAND='ssh -i PATH/TO/KEY/FILE -o IdentitiesOnly=yes' git clone git@github.com:OWNER/REPOSITORY ``` + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/merging-multiple-personal-accounts.md b/content/account-and-profile/how-tos/account-management/merging-multiple-personal-accounts.md similarity index 91% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/merging-multiple-personal-accounts.md rename to content/account-and-profile/how-tos/account-management/merging-multiple-personal-accounts.md index bb5fde6f42f3..f4e5695b6b9e 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/merging-multiple-personal-accounts.md +++ b/content/account-and-profile/how-tos/account-management/merging-multiple-personal-accounts.md @@ -1,6 +1,6 @@ --- title: Merging multiple personal accounts -intro: 'If you have separate accounts for work and personal use, you can merge the accounts.' +intro: If you have separate accounts for work and personal use, you can merge the accounts. redirect_from: - /articles/can-i-merge-two-accounts - /articles/keeping-work-and-personal-repositories-separate @@ -10,12 +10,14 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/merging-multiple-user-accounts - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/merging-multiple-personal-accounts - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/merging-multiple-personal-accounts + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/merging-multiple-personal-accounts versions: fpt: '*' ghec: '*' topics: - Accounts shortTitle: Merge multiple accounts +contentType: how-tos --- {% ifversion ghec %} diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account.md b/content/account-and-profile/how-tos/account-management/unlinking-your-email-address-from-a-locked-account.md similarity index 80% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account.md rename to content/account-and-profile/how-tos/account-management/unlinking-your-email-address-from-a-locked-account.md index 6c842db225e0..3d3ea0716a07 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account.md +++ b/content/account-and-profile/how-tos/account-management/unlinking-your-email-address-from-a-locked-account.md @@ -1,9 +1,10 @@ --- title: Unlinking your email address from a locked account -intro: 'If you have lost your two-factor authentication (2FA) credentials and are unable to recover access, you can remove the connection between your email address and a 2FA locked account.' +intro: If you have lost your two-factor authentication (2FA) credentials and are unable to recover access, you can remove the connection between your email address and a 2FA locked account. redirect_from: - /early-access/account-and-profile/unlinking-your-email-address-from-a-locked-account - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account versions: fpt: '*' ghec: '*' @@ -11,6 +12,7 @@ topics: - Accounts - 2FA shortTitle: Unlink your email +contentType: how-tos --- > [!WARNING] diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/index.md b/content/account-and-profile/how-tos/account-settings/index.md similarity index 87% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/index.md rename to content/account-and-profile/how-tos/account-settings/index.md index 6f7b70dac47e..8d3b2a57ca59 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/index.md +++ b/content/account-and-profile/how-tos/account-settings/index.md @@ -9,6 +9,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings versions: fpt: '*' ghes: '*' @@ -25,6 +26,7 @@ children: - /managing-access-to-your-personal-accounts-project-boards - /integrating-jira-with-your-personal-projects - /set-your-hiring-status -shortTitle: Personal account settings +shortTitle: Account settings +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/integrating-jira-with-your-personal-projects.md b/content/account-and-profile/how-tos/account-settings/integrating-jira-with-your-personal-projects.md similarity index 77% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/integrating-jira-with-your-personal-projects.md rename to content/account-and-profile/how-tos/account-settings/integrating-jira-with-your-personal-projects.md index 18a4da7d59c2..9198f3c07535 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/integrating-jira-with-your-personal-projects.md +++ b/content/account-and-profile/how-tos/account-settings/integrating-jira-with-your-personal-projects.md @@ -1,6 +1,6 @@ --- title: Integrating Jira with your personal projects -intro: 'You can integrate Jira Cloud with your personal account to scan commits and pull requests, creating relevant metadata and hyperlinks in any mentioned Jira issues.' +intro: You can integrate Jira Cloud with your personal account to scan commits and pull requests, creating relevant metadata and hyperlinks in any mentioned Jira issues. redirect_from: - /articles/integrating-jira-with-your-personal-projects - /github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects @@ -8,9 +8,11 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/integrating-jira-with-your-personal-projects - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/integrating-jira-with-your-personal-projects - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/integrating-jira-with-your-personal-projects + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/integrating-jira-with-your-personal-projects versions: ghes: '*' -shortTitle: Integrate Jira with projects +shortTitle: Jira project integration +contentType: how-tos --- {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} @@ -23,8 +25,9 @@ shortTitle: Integrate Jira with projects 1. Under **Developer applications**, note the "Client ID" and "Client Secret" values. {% data reusables.user-settings.jira_help_docs %} -## Further reading +## Next steps {% ifversion projects-v1 %} * [AUTOTITLE](/organizations/managing-organization-settings/integrating-jira-with-your-organization-project-board){% endif %} * [Connect Jira Cloud to GitHub](https://confluence.atlassian.com/adminjiracloud/connect-jira-cloud-to-github-814188429.html) in the Atlassian documentation +* For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/manage-cookie-preferences.md b/content/account-and-profile/how-tos/account-settings/manage-cookie-preferences.md similarity index 88% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/manage-cookie-preferences.md rename to content/account-and-profile/how-tos/account-settings/manage-cookie-preferences.md index cdd17fc70b6d..2167c70ea0d0 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/manage-cookie-preferences.md +++ b/content/account-and-profile/how-tos/account-settings/manage-cookie-preferences.md @@ -12,6 +12,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-cookie-preferences-for-githubs-enterprise-marketing-pages - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-cookie-preferences-for-githubs-enterprise-marketing-pages - /account-and-profile/tutorials/managing-your-cookie-preferences-for-githubs-enterprise-marketing-pages + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/manage-cookie-preferences contentType: how-tos --- @@ -29,3 +30,7 @@ You can customize how non-essential cookies behave on any {% data variables.prod ![Screenshot of the "Manage cookie preferences" dialog. Under "Analytics", two radio buttons, labeled "Accept" and "Reject," are outlined.](/assets/images/help/settings/cookie-settings-accept-or-reject.png) 1. Click **Save changes**. + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards.md b/content/account-and-profile/how-tos/account-settings/managing-access-to-your-personal-accounts-project-boards.md similarity index 80% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards.md rename to content/account-and-profile/how-tos/account-settings/managing-access-to-your-personal-accounts-project-boards.md index b60a9b347ec1..7c3a7168d6b0 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards.md +++ b/content/account-and-profile/how-tos/account-settings/managing-access-to-your-personal-accounts-project-boards.md @@ -1,6 +1,6 @@ --- -title: 'Managing access to your personal account''s {% data variables.projects.projects_v1_boards %}' -intro: 'As a {% data variables.projects.projects_v1_board %} owner, you can add or remove a collaborator and customize their permissions to a {% data variables.projects.projects_v1_board %}.' +title: Managing access to your personal account's {% data variables.projects.projects_v1_boards %} +intro: As a {% data variables.projects.projects_v1_board %} owner, you can add or remove a collaborator and customize their permissions to a {% data variables.projects.projects_v1_board %}. redirect_from: - /articles/managing-project-boards-in-your-repository-or-organization - /articles/managing-access-to-your-user-account-s-project-boards @@ -10,12 +10,14 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-access-to-your-user-accounts-project-boards - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-access-to-your-personal-accounts-project-boards - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards versions: feature: projects-v1 topics: - Accounts -shortTitle: 'Manage {% data variables.projects.projects_v1_boards %} access' +shortTitle: Manage access allowTitleToDifferFromFilename: true +contentType: how-tos --- A collaborator is a person who has permissions to a {% data variables.projects.projects_v1_board %} you own. A collaborator's permissions will default to read access. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account). @@ -35,3 +37,7 @@ A collaborator is a person who has permissions to a {% data variables.projects.p {% data reusables.project-management.access-collaboration-settings %} {% data reusables.project-management.collaborator-option %} {% data reusables.project-management.remove-collaborator %} + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md b/content/account-and-profile/how-tos/account-settings/managing-accessibility-settings.md similarity index 92% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md rename to content/account-and-profile/how-tos/account-settings/managing-accessibility-settings.md index 8fdcc622ded0..15a442093596 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings.md +++ b/content/account-and-profile/how-tos/account-settings/managing-accessibility-settings.md @@ -10,7 +10,8 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-accessibility-settings - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings -type: how_to + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-accessibility-settings +contentType: how-tos --- > [!NOTE] This article will help you customize your experience on the {% data variables.product.github %} website as a whole. For information on using specific {% data variables.product.github %} products with screen readers and other assistive technologies, see the [{% data variables.product.github %} Accessibility Documentation](https://accessibility.github.com/documentation). @@ -60,3 +61,7 @@ You can customize contrast levels to improve visibility and meet accessibility n 1. If you're **not signed in**, click {% octicon "sliders" aria-hidden="true" aria-label="sliders" %} on the right in the top navigation bar to access the contrast settings. 1. If you're **signed in**, click **{% octicon "paintbrush" aria-hidden="true" aria-label="paintbrush" %} Appearance** in the left sidebar of your user settings. 1. Under "Contrast", toggle the "Increase contrast" switch. + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-security-and-analysis-features.md b/content/account-and-profile/how-tos/account-settings/managing-security-and-analysis-features.md similarity index 93% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-security-and-analysis-features.md rename to content/account-and-profile/how-tos/account-settings/managing-security-and-analysis-features.md index db64ef2a1796..0f1dd4742e0f 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-security-and-analysis-features.md +++ b/content/account-and-profile/how-tos/account-settings/managing-security-and-analysis-features.md @@ -14,7 +14,8 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-security-and-analysis-settings-for-your-personal-account - /account-and-profile/tutorials/managing-security-and-analysis-settings-for-your-personal-account -shortTitle: Security & analysis + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-security-and-analysis-features +shortTitle: Security and analysis contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-tab-size-rendering-preference.md b/content/account-and-profile/how-tos/account-settings/managing-your-tab-size-rendering-preference.md similarity index 79% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-tab-size-rendering-preference.md rename to content/account-and-profile/how-tos/account-settings/managing-your-tab-size-rendering-preference.md index b43075c9553a..353890649d96 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-tab-size-rendering-preference.md +++ b/content/account-and-profile/how-tos/account-settings/managing-your-tab-size-rendering-preference.md @@ -12,6 +12,8 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-your-tab-size-rendering-preference - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-your-tab-size-rendering-preference - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-tab-size-rendering-preference + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-your-tab-size-rendering-preference +contentType: how-tos --- If you feel that tabbed indentation in code rendered on {% data variables.product.github %} takes up too much, or too little space, you can change this in your settings. @@ -19,3 +21,7 @@ If you feel that tabbed indentation in code rendered on {% data variables.produc {% data reusables.user-settings.access_settings %} 1. In the left sidebar, click **{% octicon "paintbrush" aria-hidden="true" aria-label="paintbrush" %} Appearance**. 1. Scroll down to "Tab size preference" and use the dropdown menu to choose your preference. + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md b/content/account-and-profile/how-tos/account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md similarity index 91% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md rename to content/account-and-profile/how-tos/account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md index 58f440d2e1c6..f02693c00a55 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md +++ b/content/account-and-profile/how-tos/account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account.md @@ -1,5 +1,5 @@ --- -title: 'Permission levels for a {% data variables.projects.projects_v1_board %} owned by a personal account' +title: Permission levels for a {% data variables.projects.projects_v1_board %} owned by a personal account intro: 'A {% data variables.projects.projects_v1_board %} owned by a personal account has two permission levels: the {% data variables.projects.projects_v1_board %} owner and collaborators.' redirect_from: - /articles/permission-levels-for-user-owned-project-boards @@ -8,12 +8,14 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-user-owned-project-boards - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-project-board-owned-by-a-personal-account versions: feature: projects-v1 topics: - Accounts shortTitle: '{% data variables.projects.projects_v1_board_caps %} permissions' allowTitleToDifferFromFilename: true +contentType: how-tos --- {% data reusables.projects.project_boards_old %} @@ -62,6 +64,6 @@ Collaborators with write access to a user-owned {% data variables.projects.proje You can change the {% data variables.projects.projects_v1_board %}'s visibility from private to public and back again. By default, user-owned {% data variables.projects.projects_v1_boards %} are private. For more information, see [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/changing-project-board-visibility). -## Further reading +## Next steps -* [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-access-to-your-personal-accounts-project-boards) +For reference information, see [AUTOTITLE](/account-and-profile/reference/personal-account-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/prepare-for-job-change.md b/content/account-and-profile/how-tos/account-settings/prepare-for-job-change.md similarity index 97% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/prepare-for-job-change.md rename to content/account-and-profile/how-tos/account-settings/prepare-for-job-change.md index c4a7807b16cf..67b4fff123fb 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/prepare-for-job-change.md +++ b/content/account-and-profile/how-tos/account-settings/prepare-for-job-change.md @@ -9,6 +9,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/best-practices-for-leaving-your-company - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/best-practices-for-leaving-your-company - /account-and-profile/reference/best-practices-for-leaving-your-company + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/prepare-for-job-change versions: fpt: '*' ghec: '*' diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/set-your-hiring-status.md b/content/account-and-profile/how-tos/account-settings/set-your-hiring-status.md similarity index 91% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/set-your-hiring-status.md rename to content/account-and-profile/how-tos/account-settings/set-your-hiring-status.md index dfc091d68e0e..8082b44f6dfe 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/set-your-hiring-status.md +++ b/content/account-and-profile/how-tos/account-settings/set-your-hiring-status.md @@ -10,6 +10,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/what-does-the-available-for-hire-checkbox-do - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/about-available-for-hire - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/about-available-for-hire + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/set-your-hiring-status versions: fpt: '*' ghec: '*' diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/index.md b/content/account-and-profile/how-tos/contribution-settings/index.md similarity index 85% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/index.md rename to content/account-and-profile/how-tos/contribution-settings/index.md index aa03da2a625d..a21f6abd4374 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/index.md +++ b/content/account-and-profile/how-tos/contribution-settings/index.md @@ -6,6 +6,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile versions: fpt: '*' ghes: '*' @@ -19,6 +20,7 @@ children: - /sharing-contributions-from-github-enterprise-server - /troubleshooting-missing-contributions - /viewing-commit-details-from-your-timeline -shortTitle: Manage contribution settings +shortTitle: Contribution settings +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/manage-visibility-settings-for-private-contributions-and-achievements.md b/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md similarity index 93% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/manage-visibility-settings-for-private-contributions-and-achievements.md rename to content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md index 5218710c5de2..9970ddce03c9 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/manage-visibility-settings-for-private-contributions-and-achievements.md +++ b/content/account-and-profile/how-tos/contribution-settings/manage-visibility-settings-for-private-contributions-and-achievements.md @@ -8,6 +8,7 @@ redirect_from: - /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 - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-your-private-contributions-and-achievements-on-your-profile + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/manage-visibility-settings-for-private-contributions-and-achievements versions: fpt: '*' ghes: '*' diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sharing-contributions-from-github-enterprise-server.md b/content/account-and-profile/how-tos/contribution-settings/sharing-contributions-from-github-enterprise-server.md similarity index 89% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sharing-contributions-from-github-enterprise-server.md rename to content/account-and-profile/how-tos/contribution-settings/sharing-contributions-from-github-enterprise-server.md index c369c5f195cc..7f59589a0cca 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sharing-contributions-from-github-enterprise-server.md +++ b/content/account-and-profile/how-tos/contribution-settings/sharing-contributions-from-github-enterprise-server.md @@ -1,6 +1,6 @@ --- title: Sharing contributions from GitHub Enterprise Server -intro: 'You can send contribution counts from {% data variables.product.prodname_ghe_server %} to your profile on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}.' +intro: You can send contribution counts from {% data variables.product.prodname_ghe_server %} to your profile on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}. redirect_from: - /articles/sending-your-github-enterprise-contributions-to-your-github-com-profile - /articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile @@ -10,6 +10,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/sharing-contributions-from-github-enterprise-server versions: fpt: '*' ghes: '*' @@ -17,6 +18,7 @@ versions: topics: - Profiles shortTitle: Send enterprise contributions +contentType: how-tos --- > [!IMPORTANT] diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-an-overview-of-your-activity-on-your-profile.md b/content/account-and-profile/how-tos/contribution-settings/showing-an-overview-of-your-activity-on-your-profile.md similarity index 88% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-an-overview-of-your-activity-on-your-profile.md rename to content/account-and-profile/how-tos/contribution-settings/showing-an-overview-of-your-activity-on-your-profile.md index 22199f9c4ca1..fd01c4fe1d82 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/showing-an-overview-of-your-activity-on-your-profile.md +++ b/content/account-and-profile/how-tos/contribution-settings/showing-an-overview-of-your-activity-on-your-profile.md @@ -7,6 +7,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/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: '*' @@ -14,6 +15,7 @@ versions: topics: - Profiles shortTitle: Show an overview +contentType: how-tos --- ## Managing the visibility of the activity overview on your profile diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-missing-contributions.md b/content/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions.md similarity index 97% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-missing-contributions.md rename to content/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions.md index 2848de785267..e6b516890a0f 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-missing-contributions.md +++ b/content/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions.md @@ -8,6 +8,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile - /account-and-profile/reference/why-are-my-contributions-not-showing-up-on-my-profile + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-missing-contributions versions: fpt: '*' ghes: '*' diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-commit-details-from-your-timeline.md b/content/account-and-profile/how-tos/contribution-settings/viewing-commit-details-from-your-timeline.md similarity index 95% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-commit-details-from-your-timeline.md rename to content/account-and-profile/how-tos/contribution-settings/viewing-commit-details-from-your-timeline.md index 9ddea890efab..0f2616a296cb 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-commit-details-from-your-timeline.md +++ b/content/account-and-profile/how-tos/contribution-settings/viewing-commit-details-from-your-timeline.md @@ -8,6 +8,7 @@ redirect_from: - /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 - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-commits-on-your-timeline + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-commit-details-from-your-timeline versions: fpt: '*' ghes: '*' diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile.md b/content/account-and-profile/how-tos/contribution-settings/viewing-contributions-on-your-profile.md similarity index 94% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile.md rename to content/account-and-profile/how-tos/contribution-settings/viewing-contributions-on-your-profile.md index a0b662fe6945..5af3a1aedec0 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile.md +++ b/content/account-and-profile/how-tos/contribution-settings/viewing-contributions-on-your-profile.md @@ -9,6 +9,7 @@ redirect_from: - /github/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile - /account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile - /account-and-profile/concepts/viewing-contributions-on-your-profile + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile versions: fpt: '*' ghes: '*' @@ -16,6 +17,7 @@ versions: topics: - Profiles shortTitle: View contributions +contentType: how-tos --- ## Prerequisites diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account.md b/content/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account.md similarity index 79% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account.md rename to content/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account.md index 91bfea731c7b..68fc68f87971 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account.md +++ b/content/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account.md @@ -1,12 +1,13 @@ --- title: Adding an email address to your GitHub account -intro: 'You can add multiple email addresses to your {% data variables.product.github %} account to manage commits and notifications.' +intro: You can add multiple email addresses to your {% data variables.product.github %} account to manage commits and notifications. redirect_from: - /articles/adding-an-email-address-to-your-github-account - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account versions: fpt: '*' ghes: '*' @@ -14,7 +15,8 @@ versions: topics: - Accounts - Notifications -shortTitle: Add an email address +shortTitle: Add email address +contentType: how-tos --- {% ifversion ghec %} @@ -34,3 +36,5 @@ shortTitle: Add an email address ## Next steps If you are having trouble adding an email address, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email). + +For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md b/content/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md similarity index 74% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md rename to content/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md index 7268a41fc304..cee4fc1489f6 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md +++ b/content/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address.md @@ -1,12 +1,13 @@ --- title: Blocking command line pushes that expose your personal email address -intro: 'If you''ve chosen to keep your email address private when performing web-based operations, you can also choose to block command line pushes that may expose your personal email address.' +intro: If you've chosen to keep your email address private when performing web-based operations, you can also choose to block command line pushes that may expose your personal email address. redirect_from: - /articles/blocking-command-line-pushes-that-expose-your-personal-email-address - /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 + - /account-and-profile/how-tos/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: '*' @@ -14,6 +15,7 @@ topics: - Accounts - Notifications shortTitle: Block push with personal email +contentType: how-tos --- When you enable this setting, each time you push to {% data variables.product.github %}, we’ll check the most recent commit. If the author email on that commit is a private email on your GitHub account, we will block the push and warn you about exposing your private email. @@ -21,3 +23,7 @@ When you enable this setting, each time you push to {% data variables.product.gi {% data reusables.user-settings.emails %} {% data reusables.user-settings.keeping_your_email_address_private %} 1. To keep your email address private in commits you push from the command line, select **Block command line pushes that expose my email**. + +## Next steps + +* For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address.md b/content/account-and-profile/how-tos/email-preferences/changing-your-primary-email-address.md similarity index 83% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address.md rename to content/account-and-profile/how-tos/email-preferences/changing-your-primary-email-address.md index fb961fb311e8..be3ea02e1159 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address.md +++ b/content/account-and-profile/how-tos/email-preferences/changing-your-primary-email-address.md @@ -1,12 +1,13 @@ --- 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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address versions: fpt: '*' ghes: '*' @@ -15,6 +16,7 @@ topics: - Accounts - Notifications shortTitle: Primary email address +contentType: how-tos --- {% ifversion ghec %} @@ -31,3 +33,7 @@ shortTitle: Primary email address {% ifversion fpt or ghec %} 1. Verify your new primary email address. Without a verified email address, you won't be able to use all of {% data variables.product.github %}'s features. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address). {% endif %} + +## Next steps + +* For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/index.md b/content/account-and-profile/how-tos/email-preferences/index.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/index.md rename to content/account-and-profile/how-tos/email-preferences/index.md index 461ff20c6962..c3c6ca866f81 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/index.md +++ b/content/account-and-profile/how-tos/email-preferences/index.md @@ -7,6 +7,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences versions: fpt: '*' ghes: '*' @@ -24,6 +25,7 @@ children: - /remembering-your-github-username-or-email - /troubleshooting-adding-an-email - /troubleshooting-email-verification -shortTitle: Manage email preferences +shortTitle: Email preferences +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/remembering-your-github-username-or-email.md b/content/account-and-profile/how-tos/email-preferences/remembering-your-github-username-or-email.md similarity index 90% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/remembering-your-github-username-or-email.md rename to content/account-and-profile/how-tos/email-preferences/remembering-your-github-username-or-email.md index 9ffbf68b9afd..21d5c25d3aff 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/remembering-your-github-username-or-email.md +++ b/content/account-and-profile/how-tos/email-preferences/remembering-your-github-username-or-email.md @@ -1,6 +1,6 @@ --- title: Remembering your GitHub username or email -intro: 'Are you signing in for the first time in a while? If so, welcome back! If you can''t remember the username for your personal account, you can try these methods for remembering it.' +intro: Are you signing in for the first time in a while? If so, welcome back! If you can't remember the username for your personal account, you can try these methods for remembering it. redirect_from: - /articles/oh-noes-i-ve-forgotten-my-username-email - /articles/oh-noes-i-ve-forgotten-my-username-or-email @@ -9,6 +9,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/remembering-your-github-username-or-email versions: fpt: '*' ghes: '*' @@ -17,6 +18,7 @@ topics: - Accounts - Notifications shortTitle: Find your username or email +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-a-backup-email-address.md b/content/account-and-profile/how-tos/email-preferences/setting-a-backup-email-address.md similarity index 77% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-a-backup-email-address.md rename to content/account-and-profile/how-tos/email-preferences/setting-a-backup-email-address.md index 11a1b9d8c7d7..163354d75728 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-a-backup-email-address.md +++ b/content/account-and-profile/how-tos/email-preferences/setting-a-backup-email-address.md @@ -7,6 +7,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-a-backup-email-address versions: fpt: '*' ghes: '*' @@ -14,14 +15,14 @@ versions: topics: - Accounts - Notifications -shortTitle: Set backup email address +shortTitle: Backup email address +contentType: how-tos --- {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.emails %} 1. Under "Backup email address," use the dropdown menu to select the address you want to set as your backup email address. 1. Click **Save**. -## Further reading +## Next steps -* [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences) -* [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials) +* For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address.md b/content/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address.md similarity index 89% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address.md rename to content/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address.md index 1fa3f87dc433..ae0c4f0e0d61 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address.md +++ b/content/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address.md @@ -1,6 +1,6 @@ --- title: Setting your commit email address -intro: 'You can set the email address that is used to author commits on {% data variables.product.github %} and on your computer.' +intro: You can set the email address that is used to author commits on {% data variables.product.github %} and on your computer. redirect_from: - /articles/keeping-your-email-address-private - /articles/setting-your-commit-email-address-on-github @@ -14,6 +14,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address versions: fpt: '*' ghes: '*' @@ -22,6 +23,7 @@ topics: - Accounts - Notifications shortTitle: Set commit email address +contentType: how-tos --- ## Setting your commit email address on {% data variables.product.github %} @@ -83,4 +85,6 @@ You can change the email address associated with commits you make in a single re ## Next steps +For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). + To learn more about using a private email address, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference#your-noreply-email-address). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email.md b/content/account-and-profile/how-tos/email-preferences/troubleshooting-adding-an-email.md similarity index 83% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email.md rename to content/account-and-profile/how-tos/email-preferences/troubleshooting-adding-an-email.md index 24d3970bcfab..81e9c3186a32 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email.md +++ b/content/account-and-profile/how-tos/email-preferences/troubleshooting-adding-an-email.md @@ -1,6 +1,6 @@ --- title: Troubleshooting adding an email -intro: 'Troubleshoot problems when adding an email address to your {% data variables.product.github %} account.' +intro: Troubleshoot problems when adding an email address to your {% data variables.product.github %} account. versions: fpt: '*' ghes: '*' @@ -10,6 +10,9 @@ topics: - Notifications - Troubleshooting shortTitle: Troubleshoot adding an email +contentType: how-tos +redirect_from: + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email --- ## Email already in use @@ -30,3 +33,7 @@ Reach out to your site administrator or internal IT helpdesk to learn about thei If you want to use your email address with a personal account, you must sign in to your {% data variables.enterprise.prodname_managed_user %} and unverify the email in your account settings. The email will remain linked to your {% data variables.enterprise.prodname_managed_user %}, allowing you to access the account through your organization's IdP. However, some third-party apps or services may not function properly with a {% data variables.enterprise.prodname_managed_user %} that has an unverified email address. + +## Next steps + +* For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-email-verification.md b/content/account-and-profile/how-tos/email-preferences/troubleshooting-email-verification.md similarity index 77% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-email-verification.md rename to content/account-and-profile/how-tos/email-preferences/troubleshooting-email-verification.md index 7593a2fe4cd1..4e49ced96e28 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-email-verification.md +++ b/content/account-and-profile/how-tos/email-preferences/troubleshooting-email-verification.md @@ -1,6 +1,6 @@ --- title: Troubleshooting email verification -intro: 'Troubleshoot problems when verifying your email address.' +intro: Troubleshoot problems when verifying your email address. versions: fpt: '*' ghes: '*' @@ -9,7 +9,10 @@ topics: - Accounts - Notifications - Troubleshooting -shortTitle: Troubleshoot verifying an email +shortTitle: Troubleshoot email verification +contentType: how-tos +redirect_from: + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-email-verification --- ## Unable to send verification email @@ -32,3 +35,7 @@ If you click on the link in the confirmation email within 24 hours and you are d If you see the error message `Error adding EMAIL: Email is already verified by another user`, you must either unverify the email for the other account before proceeding, or choose a different email address to verify. To unverify an email address, delete it in your email settings, then optionally re-add it without verifying to keep any commits linked to your account. See [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/changing-your-primary-email-address). + +## Next steps + +* For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address.md b/content/account-and-profile/how-tos/email-preferences/verifying-your-email-address.md similarity index 74% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address.md rename to content/account-and-profile/how-tos/email-preferences/verifying-your-email-address.md index 2ae4ea6ac75c..947e7a6c69ca 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address.md +++ b/content/account-and-profile/how-tos/email-preferences/verifying-your-email-address.md @@ -1,6 +1,6 @@ --- title: Verifying your email address -intro: 'Verifying your primary email address ensures strengthened security, allows {% data variables.product.prodname_dotcom %} staff to better assist you if you forget your password, and gives you access to more features on {% data variables.product.prodname_dotcom %}.' +intro: Verifying your primary email address ensures strengthened security, allows {% data variables.product.prodname_dotcom %} staff to better assist you if you forget your password, and gives you access to more features on {% data variables.product.prodname_dotcom %}. redirect_from: - /articles/troubleshooting-email-verification - /articles/setting-up-email-verification @@ -9,12 +9,14 @@ redirect_from: - /github/getting-started-with-github/signing-up-for-github/verifying-your-email-address - /get-started/signing-up-for-github/verifying-your-email-address - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address versions: fpt: '*' ghec: '*' topics: - Accounts shortTitle: Verify your email address +contentType: how-tos --- ## Verifying your email address @@ -28,4 +30,6 @@ shortTitle: Verify your email address ## Next steps +For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference). + If you are having trouble verifying your email address, see [AUTOTITLE](/free-pro-team@latest/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-email-verification). diff --git a/content/account-and-profile/how-tos/index.md b/content/account-and-profile/how-tos/index.md index 5b5bff7d120a..45eac0c7a0de 100644 --- a/content/account-and-profile/how-tos/index.md +++ b/content/account-and-profile/how-tos/index.md @@ -1,13 +1,28 @@ --- 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.' +intro: Learn how to accomplish specific tasks for your {% data variables.product.github %} account and profile. versions: fpt: '*' ghes: '*' ghec: '*' +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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile + - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github children: - - /setting-up-and-managing-your-github-profile - - /setting-up-and-managing-your-personal-account-on-github + - /account-management + - /account-settings + - /profile-customization + - /contribution-settings + - /organization-membership + - /email-preferences +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/accessing-an-organization.md b/content/account-and-profile/how-tos/organization-membership/accessing-an-organization.md similarity index 79% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/accessing-an-organization.md rename to content/account-and-profile/how-tos/organization-membership/accessing-an-organization.md index 74113c9cd90d..3951eef31af1 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/accessing-an-organization.md +++ b/content/account-and-profile/how-tos/organization-membership/accessing-an-organization.md @@ -1,7 +1,7 @@ --- title: Accessing an organization shortTitle: Access an organization -intro: 'To access an organization that you''re a member of, you must sign in to your personal account.' +intro: To access an organization that you're a member of, you must sign in to your personal account. redirect_from: - /articles/error-cannot-log-in-that-account-is-an-organization - /articles/cannot-log-in-that-account-is-an-organization @@ -11,12 +11,14 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/accessing-an-organization - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/accessing-an-organization - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/accessing-an-organization + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/accessing-an-organization versions: fpt: '*' ghes: '*' ghec: '*' topics: - Accounts +contentType: how-tos --- > [!TIP] diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/index.md b/content/account-and-profile/how-tos/organization-membership/index.md similarity index 68% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/index.md rename to content/account-and-profile/how-tos/organization-membership/index.md index 33805aa1c9be..97c307d3b6d8 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/index.md +++ b/content/account-and-profile/how-tos/organization-membership/index.md @@ -1,11 +1,12 @@ --- title: Managing your membership in organizations -intro: 'If you''re a member of an organization, you can publicize or hide your membership, view other people''s roles, and remove yourself from the organization.' +intro: If you're a member of an organization, you can publicize or hide your membership, view other people's roles, and remove yourself from the organization. redirect_from: - /articles/managing-your-membership-in-organizations - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations versions: fpt: '*' ghes: '*' @@ -17,8 +18,8 @@ children: - /viewing-peoples-roles-in-an-organization - /requesting-organization-approval-for-oauth-apps - /publicizing-or-hiding-organization-membership - - /managing-your-scheduled-reminders - /removing-yourself-from-an-organization -shortTitle: Manage organization membership +shortTitle: Organization membership +contentType: how-tos --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership.md b/content/account-and-profile/how-tos/organization-membership/publicizing-or-hiding-organization-membership.md similarity index 82% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership.md rename to content/account-and-profile/how-tos/organization-membership/publicizing-or-hiding-organization-membership.md index 1002556396a5..20fbbef72471 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership.md +++ b/content/account-and-profile/how-tos/organization-membership/publicizing-or-hiding-organization-membership.md @@ -1,6 +1,6 @@ --- title: Publicizing or hiding organization membership -intro: 'If you''d like to tell the world which organizations you belong to, you can display the avatars of the organizations on your profile.' +intro: If you'd like to tell the world which organizations you belong to, you can display the avatars of the organizations on your profile. redirect_from: - /articles/publicizing-or-concealing-organization-membership - /articles/publicizing-or-hiding-organization-membership @@ -8,6 +8,7 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership versions: fpt: '*' ghes: '*' @@ -15,6 +16,7 @@ versions: topics: - Accounts shortTitle: Show or hide membership +contentType: how-tos --- {% data reusables.profile.access_org %} diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization.md b/content/account-and-profile/how-tos/organization-membership/removing-yourself-from-an-organization.md similarity index 84% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization.md rename to content/account-and-profile/how-tos/organization-membership/removing-yourself-from-an-organization.md index bfaf86852f1d..333178b0f093 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization.md +++ b/content/account-and-profile/how-tos/organization-membership/removing-yourself-from-an-organization.md @@ -1,6 +1,6 @@ --- title: Removing yourself from an organization -intro: 'If you''re an outside collaborator or a member of an organization, you can leave the organization at any time.' +intro: If you're an outside collaborator or a member of an organization, you can leave the organization at any time. redirect_from: - /articles/how-do-i-remove-myself-from-an-organization - /articles/removing-yourself-from-an-organization @@ -8,6 +8,7 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/removing-yourself-from-an-organization - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/removing-yourself-from-an-organization - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization versions: fpt: '*' ghes: '*' @@ -15,6 +16,7 @@ versions: topics: - Accounts shortTitle: Leave an organization +contentType: how-tos --- {% ifversion fpt or ghec %} diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps.md b/content/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps.md rename to content/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps.md index 65908a5a28bc..3e9b4f12957a 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps.md +++ b/content/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps.md @@ -1,6 +1,6 @@ --- title: Requesting organization approval for OAuth apps -intro: 'You can request approval for {% data variables.product.prodname_oauth_apps %} to access organization resources.' +intro: You can request approval for {% data variables.product.prodname_oauth_apps %} to access organization resources. redirect_from: - /articles/requesting-organization-approval-for-third-party-applications - /articles/requesting-organization-approval-for-your-authorized-applications @@ -9,13 +9,15 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps versions: fpt: '*' ghec: '*' topics: - Accounts permissions: Organization members can request owner approval for {% data variables.product.prodname_oauth_apps %}. Outside collaborators can request owner approval for {% data variables.product.prodname_oauth_apps %} if integration access requests are enabled. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests). -shortTitle: 'Request {% data variables.product.prodname_oauth_app %} approval' +shortTitle: Request {% data variables.product.prodname_oauth_app %} approval +contentType: how-tos --- ## Prerequisites diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization.md b/content/account-and-profile/how-tos/organization-membership/viewing-peoples-roles-in-an-organization.md similarity index 90% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization.md rename to content/account-and-profile/how-tos/organization-membership/viewing-peoples-roles-in-an-organization.md index aa3ddf96c58d..d34d9e4a9fd2 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization.md +++ b/content/account-and-profile/how-tos/organization-membership/viewing-peoples-roles-in-an-organization.md @@ -1,6 +1,6 @@ --- title: Viewing people's roles in an organization -intro: 'You can view a list of the people in your organization and filter by their role.' +intro: You can view a list of the people in your organization and filter by their role. permissions: Organization members redirect_from: - /articles/viewing-people-s-roles-in-an-organization @@ -9,6 +9,7 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/viewing-peoples-roles-in-an-organization versions: fpt: '*' ghes: '*' @@ -16,6 +17,7 @@ versions: topics: - Accounts shortTitle: View organization members +contentType: how-tos --- {% ifversion ghes or ghec %} diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/index.md b/content/account-and-profile/how-tos/profile-customization/index.md similarity index 78% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/index.md rename to content/account-and-profile/how-tos/profile-customization/index.md index caf82af24f8d..db745757c011 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/index.md +++ b/content/account-and-profile/how-tos/profile-customization/index.md @@ -5,6 +5,7 @@ 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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile versions: fpt: '*' ghes: '*' @@ -15,5 +16,7 @@ children: - /managing-your-profile-readme - /pinning-items-to-your-profile - /setting-your-profile-to-private +contentType: how-tos +shortTitle: Profile customization --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md b/content/account-and-profile/how-tos/profile-customization/managing-your-profile-readme.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md rename to content/account-and-profile/how-tos/profile-customization/managing-your-profile-readme.md index 07678eae5258..209184142625 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme.md +++ b/content/account-and-profile/how-tos/profile-customization/managing-your-profile-readme.md @@ -1,18 +1,20 @@ --- title: Managing your profile README -intro: 'You can add a README to your {% data variables.product.prodname_dotcom %} profile to tell other people about yourself.' +intro: You can add a README to your {% data variables.product.prodname_dotcom %} profile to tell other people about yourself. versions: fpt: '*' ghes: '*' ghec: '*' topics: - Profiles -permissions: 'Profile READMEs are not available to {% data variables.enterprise.prodname_managed_users %}.' +permissions: Profile READMEs are not available to {% data variables.enterprise.prodname_managed_users %}. 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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme shortTitle: Your profile README +contentType: how-tos --- ## Prerequisites diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile.md b/content/account-and-profile/how-tos/profile-customization/pinning-items-to-your-profile.md similarity index 92% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile.md rename to content/account-and-profile/how-tos/profile-customization/pinning-items-to-your-profile.md index d1e744280fdf..1d803de04d40 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile.md +++ b/content/account-and-profile/how-tos/profile-customization/pinning-items-to-your-profile.md @@ -7,6 +7,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/pinning-items-to-your-profile versions: fpt: '*' ghes: '*' @@ -14,6 +15,7 @@ versions: topics: - Profiles shortTitle: Pin items +contentType: how-tos --- ## Pinning items to your profile diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md b/content/account-and-profile/how-tos/profile-customization/setting-your-profile-to-private.md similarity index 78% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md rename to content/account-and-profile/how-tos/profile-customization/setting-your-profile-to-private.md index e13783c7738f..3a59f521632e 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private.md +++ b/content/account-and-profile/how-tos/profile-customization/setting-your-profile-to-private.md @@ -1,6 +1,6 @@ --- title: Setting your profile to private -intro: 'A private profile displays only limited information, and hides some activity.' +intro: A private profile displays only limited information, and hides some activity. versions: fpt: '*' topics: @@ -8,6 +8,8 @@ topics: 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 + - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/setting-your-profile-to-private +contentType: how-tos --- ## Changing your profile's privacy settings diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/index.md b/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/index.md deleted file mode 100644 index f8b9b549887b..000000000000 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-github-profile/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Setting up and managing your GitHub profile -intro: You can customize your GitHub profile and manage your contribution graph. -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: '*' - ghec: '*' -topics: - - Profiles -children: - - /customizing-your-profile - - /managing-contribution-settings-on-your-profile ---- - diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/index.md b/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/index.md deleted file mode 100644 index 971bc889bcb6..000000000000 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Setting up and managing your personal account on GitHub -intro: 'You can manage settings for your personal account on {% data variables.product.prodname_dotcom %}, including email preferences, access to personal repositories, and organization memberships. You can also manage the account itself.' -shortTitle: Personal accounts -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: '*' - ghec: '*' -topics: - - Accounts -children: - - /managing-user-account-settings - - /managing-your-personal-account - - /managing-email-preferences - - /managing-access-to-your-personal-repositories - - /managing-your-membership-in-organizations ---- - diff --git a/content/account-and-profile/index.md b/content/account-and-profile/index.md index f88db87470f2..b5f5ac8299ff 100644 --- a/content/account-and-profile/index.md +++ b/content/account-and-profile/index.md @@ -7,14 +7,14 @@ introLinks: - /get-started/onboarding/getting-started-with-your-github-account featuredLinks: startHere: - - /account-and-profile/concepts/username-changes - - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme + - /account-and-profile/get-started/account + - /account-and-profile/get-started/profile popular: - - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address - - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository + - /account-and-profile/how-tos/email-preferences/setting-your-commit-email-address + - /account-and-profile/concepts/account-management guideCards: - - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/troubleshooting-missing-contributions - - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address + - /account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions + - /account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address changelog: label: profiles, github-themes versions: @@ -34,5 +34,6 @@ children: - /how-tos - /tutorials - /reference +contentType: landing --- diff --git a/content/account-and-profile/reference/email-addresses-reference.md b/content/account-and-profile/reference/email-addresses-reference.md index ec730164f617..7a7ed95ac135 100644 --- a/content/account-and-profile/reference/email-addresses-reference.md +++ b/content/account-and-profile/reference/email-addresses-reference.md @@ -1,13 +1,14 @@ --- title: Email addresses reference shortTitle: Email addresses -intro: 'Find information about your email addresses on {% data variables.product.github %}, including verification, privacy, and commit attribution.' +intro: Find information about your email addresses on {% data variables.product.github %}, including verification, privacy, and commit attribution. topics: - Accounts versions: fpt: '*' ghes: '*' ghec: '*' +contentType: reference --- ## Email verification restrictions diff --git a/content/account-and-profile/reference/index.md b/content/account-and-profile/reference/index.md index bb47bc60064b..4958c2eb0c2a 100644 --- a/content/account-and-profile/reference/index.md +++ b/content/account-and-profile/reference/index.md @@ -9,11 +9,10 @@ versions: children: - /profile-reference - /personal-dashboard - - /permission-levels-for-a-personal-account-repository - /profile-contributions-reference - - /types-of-emails-github-sends - /email-addresses-reference - /personal-account-reference - /username-reference +contentType: reference --- diff --git a/content/account-and-profile/reference/personal-account-reference.md b/content/account-and-profile/reference/personal-account-reference.md index f74a641d0e75..56eecf48dc04 100644 --- a/content/account-and-profile/reference/personal-account-reference.md +++ b/content/account-and-profile/reference/personal-account-reference.md @@ -1,13 +1,14 @@ --- title: Personal account reference shortTitle: Personal account -intro: 'Find information about the side effects of deleting, converting, and merging your personal account on {% data variables.product.github %}.' +intro: Find information about the side effects of deleting, converting, and merging your personal account on {% data variables.product.github %}. topics: - Accounts versions: fpt: '*' ghes: '*' ghec: '*' +contentType: reference --- ## Side effects of account deletion diff --git a/content/account-and-profile/reference/personal-dashboard.md b/content/account-and-profile/reference/personal-dashboard.md index 7ecc9a470c97..7e62226afea3 100644 --- a/content/account-and-profile/reference/personal-dashboard.md +++ b/content/account-and-profile/reference/personal-dashboard.md @@ -1,12 +1,13 @@ --- title: Personal dashboard -intro: 'Find information on the display criteria for items on your personal dashboard.' +intro: Find information on the display criteria for items on your personal dashboard. versions: fpt: '*' ghec: '*' ghes: '*' topics: - Accounts +contentType: reference --- ## Recent activity diff --git a/content/account-and-profile/reference/profile-contributions-reference.md b/content/account-and-profile/reference/profile-contributions-reference.md index 86ffc4dc5dcc..608d308c8298 100644 --- a/content/account-and-profile/reference/profile-contributions-reference.md +++ b/content/account-and-profile/reference/profile-contributions-reference.md @@ -1,12 +1,13 @@ --- title: Profile contributions reference -intro: 'Find information on what is visible on your contributions graph.' +intro: Find information on what is visible on your contributions graph. versions: fpt: '*' ghec: '*' ghes: '*' topics: - Profile +contentType: reference --- ## What counts as a contribution diff --git a/content/account-and-profile/reference/profile-reference.md b/content/account-and-profile/reference/profile-reference.md index 0fe1c47a3a61..2b555d8a3f8d 100644 --- a/content/account-and-profile/reference/profile-reference.md +++ b/content/account-and-profile/reference/profile-reference.md @@ -1,6 +1,6 @@ --- title: Profile reference -intro: 'Reference information for your {% data variables.product.github %} profile.' +intro: Reference information for your {% data variables.product.github %} profile. versions: fpt: '*' ghes: '*' @@ -8,6 +8,7 @@ versions: topics: - Profiles shortTitle: Profile reference +contentType: reference --- ## Visibility of profile information diff --git a/content/account-and-profile/reference/username-reference.md b/content/account-and-profile/reference/username-reference.md index b2dca7dd21b7..f0e5a62f01ae 100644 --- a/content/account-and-profile/reference/username-reference.md +++ b/content/account-and-profile/reference/username-reference.md @@ -1,7 +1,7 @@ --- title: Username reference shortTitle: Username reference -intro: 'Find information about changing your {% data variables.product.github %} username.' +intro: Find information about changing your {% data variables.product.github %} username. topics: - Accounts - Usernames @@ -9,6 +9,7 @@ versions: fpt: '*' ghes: '*' ghec: '*' +contentType: reference --- ## Changing your username diff --git a/content/account-and-profile/tutorials/index.md b/content/account-and-profile/tutorials/index.md index 67233acc36f2..beb9d01e1b62 100644 --- a/content/account-and-profile/tutorials/index.md +++ b/content/account-and-profile/tutorials/index.md @@ -12,5 +12,6 @@ topics: children: - /personalize-your-profile - /using-your-github-profile-to-enhance-your-resume +contentType: tutorials --- diff --git a/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md b/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md index 166ae1668c85..790860734660 100644 --- a/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md +++ b/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md @@ -1,6 +1,6 @@ --- title: Using your GitHub profile to enhance your resume -intro: 'Demonstrate your skills to hiring managers with your {% data variables.product.github %} profile.' +intro: Demonstrate your skills to hiring managers with your {% data variables.product.github %} profile. versions: fpt: '*' topics: @@ -8,6 +8,7 @@ topics: shortTitle: Enhance your resume redirect_from: - /account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/using-your-github-profile-to-enhance-your-resume +contentType: tutorials --- ## How can my {% data variables.product.github %} profile help with my job search? diff --git a/content/account-and-profile/concepts/personal-repository-access-and-collaboration.md b/content/repositories/creating-and-managing-repositories/access-to-repositories.md similarity index 87% rename from content/account-and-profile/concepts/personal-repository-access-and-collaboration.md rename to content/repositories/creating-and-managing-repositories/access-to-repositories.md index a03ccc56b62b..698940d1703c 100644 --- a/content/account-and-profile/concepts/personal-repository-access-and-collaboration.md +++ b/content/repositories/creating-and-managing-repositories/access-to-repositories.md @@ -1,6 +1,6 @@ --- title: Personal repository access and collaboration -intro: 'Learn how to manage access and collaboration for repositories you own with your personal account on {% data variables.product.github %}.' +intro: Learn how to manage access and collaboration for repositories you own with your personal account on {% data variables.product.github %}. versions: fpt: '*' ghes: '*' @@ -11,6 +11,10 @@ topics: - Privacy - Open Source shortTitle: Access to repositories +contentType: other +redirect_from: + - /account-and-profile/concepts/personal-repository-access-and-collaboration + - /account-and-profile/concepts/access-to-repositories --- ## About collaboration in a personal repository diff --git a/content/repositories/creating-and-managing-repositories/index.md b/content/repositories/creating-and-managing-repositories/index.md index 6b02abb5e163..36516d42b6d1 100644 --- a/content/repositories/creating-and-managing-repositories/index.md +++ b/content/repositories/creating-and-managing-repositories/index.md @@ -1,6 +1,6 @@ --- title: Creating and managing repositories -intro: 'You can create a repository on {% data variables.product.github %} to store and collaborate on your project''s files, then manage the repository''s name and location.' +intro: You can create a repository on {% data variables.product.github %} to store and collaborate on your project's files, then manage the repository's name and location. redirect_from: - /articles/creating-a-repository-on-github - /github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github @@ -16,6 +16,7 @@ children: - /quickstart-for-repositories - /repository-limits - /creating-a-new-repository + - /access-to-repositories - /creating-a-repository-from-a-template - /creating-a-template-repository - /creating-an-issues-only-repository @@ -28,3 +29,4 @@ children: - /restoring-a-deleted-repository shortTitle: Create & manage repositories --- + diff --git a/content/repositories/managing-your-repositorys-settings-and-features/index.md b/content/repositories/managing-your-repositorys-settings-and-features/index.md index d808450d1479..d5c33a07309c 100644 --- a/content/repositories/managing-your-repositorys-settings-and-features/index.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/index.md @@ -1,6 +1,6 @@ --- title: Managing your repository’s settings and features -intro: 'You can customize your repository, enable or disable optional features for your repository, and manage your repository’s settings.' +intro: You can customize your repository, enable or disable optional features for your repository, and manage your repository’s settings. redirect_from: - /categories/administering-a-repository - /articles/managing-repository-settings @@ -12,8 +12,10 @@ versions: topics: - Repositories children: + - /repository-access-and-collaboration - /customizing-your-repository - /enabling-features-for-your-repository - /managing-repository-settings shortTitle: Manage repository settings --- + diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/index.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/index.md similarity index 80% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/index.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/index.md index f3e78930b988..1eb72cf30123 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/index.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/index.md @@ -8,6 +8,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/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: '*' @@ -19,8 +20,10 @@ topics: children: - /inviting-collaborators-to-a-personal-repository - /removing-a-collaborator-from-a-personal-repository + - /permission-levels-for-a-personal-account-repository - /removing-yourself-from-a-collaborators-repository - /maintaining-ownership-continuity-of-your-personal-accounts-repositories -shortTitle: Manage repository access +shortTitle: Repository access and collaboration +contentType: other --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md similarity index 87% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md index cc7055d460cc..fe7137779043 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/inviting-collaborators-to-a-personal-repository.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: Inviting collaborators to a personal repository -intro: 'You can {% ifversion fpt or ghec %}invite users to become{% else %}add users as{% endif %} collaborators to your personal repository.' +intro: You can {% ifversion fpt or ghec %}invite users to become{% else %}add users as{% endif %} collaborators to your personal repository. redirect_from: - /articles/how-do-i-add-a-collaborator - /articles/adding-collaborators-to-a-personal-repository @@ -9,6 +9,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/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: '*' @@ -18,6 +19,7 @@ topics: - Accounts - Repositories shortTitle: Invite collaborators +contentType: other --- ## Inviting a collaborator to a personal repository diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md similarity index 88% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md index 73b7387142b1..b217d75fff79 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md @@ -12,7 +12,9 @@ redirect_from: - /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 + - /account-and-profile/how-tos/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 +contentType: other --- ## Inviting a successor diff --git a/content/account-and-profile/reference/permission-levels-for-a-personal-account-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md similarity index 99% rename from content/account-and-profile/reference/permission-levels-for-a-personal-account-repository.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md index 3958f6b83470..4ac956f4f9f8 100644 --- a/content/account-and-profile/reference/permission-levels-for-a-personal-account-repository.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md @@ -8,6 +8,7 @@ redirect_from: - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/permission-levels-for-a-user-account-repository - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/permission-levels-for-a-personal-account-repository - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/permission-levels-for-a-personal-account-repository + - /account-and-profile/reference/permission-levels-for-a-personal-account-repository versions: fpt: '*' ghes: '*' @@ -15,6 +16,7 @@ versions: topics: - Accounts shortTitle: Repository permissions +contentType: other --- > [!TIP] diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md similarity index 86% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md index 0d9304e4d8a9..33d36f8114cc 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-a-collaborator-from-a-personal-repository.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md @@ -1,6 +1,6 @@ --- title: Removing a collaborator from a personal repository -intro: 'You can remove a collaborator from your personal repository at any time.' +intro: You can remove a collaborator from your personal repository at any time. redirect_from: - /articles/how-do-i-remove-a-collaborator - /articles/what-happens-when-i-remove-a-collaborator-from-my-private-repository @@ -12,6 +12,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/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: '*' @@ -21,6 +22,7 @@ topics: - Accounts - Repositories shortTitle: Remove a collaborator +contentType: other --- ## Removing collaborator permissions from a person contributing to a repository diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md similarity index 72% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository.md rename to content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md index 60f98c7c8037..611f6de51dd2 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository.md +++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md @@ -1,6 +1,6 @@ --- title: Removing yourself from a collaborator's repository -intro: 'If you no longer want to be a collaborator on someone else''s repository, you can remove yourself.' +intro: If you no longer want to be a collaborator on someone else's repository, you can remove yourself. redirect_from: - /leave-a-collaborative-repo - /leave-a-repo @@ -11,6 +11,7 @@ redirect_from: - /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 + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/removing-yourself-from-a-collaborators-repository versions: fpt: '*' ghes: '*' @@ -19,8 +20,13 @@ topics: - Accounts - Repositories shortTitle: Remove yourself +contentType: other --- {% data reusables.user-settings.access_settings %} 1. In the "Code, planning, and automation" section of the sidebar, click **{% octicon "repo" aria-hidden="true" aria-label="repo" %} Repositories**. 1. Next to the repository you want to leave, click **Leave**. 1. Read the warning carefully, then click **I understand, leave this repository.** + +## Next steps + +For reference information, see [AUTOTITLE](/account-and-profile/reference/permission-levels-for-a-personal-account-repository#collaborator-access-for-a-repository-owned-by-a-personal-account). diff --git a/content/subscriptions-and-notifications/concepts/index.md b/content/subscriptions-and-notifications/concepts/index.md index 3a8f71d5b2b6..6ee048689947 100644 --- a/content/subscriptions-and-notifications/concepts/index.md +++ b/content/subscriptions-and-notifications/concepts/index.md @@ -1,7 +1,7 @@ --- title: Concepts for your GitHub notifications shortTitle: Concepts -intro: 'Learn the core concepts for your {% data variables.product.github %} notifications and subscriptions.' +intro: Learn the core concepts for your {% data variables.product.github %} notifications and subscriptions. versions: fpt: '*' ghes: '*' @@ -10,5 +10,6 @@ topics: - Notifications children: - /about-notifications + - /scheduled-reminders --- diff --git a/content/account-and-profile/concepts/scheduled-reminders.md b/content/subscriptions-and-notifications/concepts/scheduled-reminders.md similarity index 88% rename from content/account-and-profile/concepts/scheduled-reminders.md rename to content/subscriptions-and-notifications/concepts/scheduled-reminders.md index fd406dd1d571..02cd5b4bfe82 100644 --- a/content/account-and-profile/concepts/scheduled-reminders.md +++ b/content/subscriptions-and-notifications/concepts/scheduled-reminders.md @@ -1,11 +1,14 @@ --- title: Scheduled reminders -intro: 'You can set scheduled reminders for requested reviews on pull requests in your organization.' +intro: You can set scheduled reminders for requested reviews on pull requests in your organization. versions: fpt: '*' ghec: '*' topics: - Accounts +contentType: concepts +redirect_from: + - /account-and-profile/concepts/scheduled-reminders --- Scheduled reminders are used to make sure that users focus on the most important review requests that require their attention. Scheduled reminders for pull requests will send a message to you in Slack with open pull requests needing your review at a specified time. For example, you can setup scheduled reminders to send you a message in Slack every morning at 10 AM with pull requests needing to be reviewed by you or one of your teams. diff --git a/content/subscriptions-and-notifications/how-tos/index.md b/content/subscriptions-and-notifications/how-tos/index.md index 1ef85edc89b0..884e03b85fde 100644 --- a/content/subscriptions-and-notifications/how-tos/index.md +++ b/content/subscriptions-and-notifications/how-tos/index.md @@ -1,7 +1,7 @@ --- title: How-tos for your GitHub notifications shortTitle: How-tos -intro: 'Learn how to accomplish specific tasks for your {% data variables.product.github %} notifications.' +intro: Learn how to accomplish specific tasks for your {% data variables.product.github %} notifications. versions: fpt: '*' ghes: '*' @@ -11,6 +11,7 @@ children: - /viewing-and-triaging-notifications - /managing-organization-notifications - /managing-github-actions-notifications + - /managing-your-scheduled-reminders - /managing-security-notifications - /managing-marketing-emails-from-github --- diff --git a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/managing-your-scheduled-reminders.md b/content/subscriptions-and-notifications/how-tos/managing-your-scheduled-reminders.md similarity index 94% rename from content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/managing-your-scheduled-reminders.md rename to content/subscriptions-and-notifications/how-tos/managing-your-scheduled-reminders.md index 4fe5381a069e..b0adfbc99720 100644 --- a/content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/managing-your-scheduled-reminders.md +++ b/content/subscriptions-and-notifications/how-tos/managing-your-scheduled-reminders.md @@ -11,7 +11,9 @@ redirect_from: - /github/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/managing-your-scheduled-reminders + - /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/managing-your-scheduled-reminders shortTitle: Manage scheduled reminders +contentType: how-tos --- ## Creating scheduled reminders for your personal account diff --git a/content/subscriptions-and-notifications/reference/index.md b/content/subscriptions-and-notifications/reference/index.md index f9956bd0da11..ffa6c694e2a6 100644 --- a/content/subscriptions-and-notifications/reference/index.md +++ b/content/subscriptions-and-notifications/reference/index.md @@ -1,7 +1,7 @@ --- title: Reference for subscriptions and notifications shortTitle: Reference -intro: 'Find information to use when managing your subscriptions and notifications on {% data variables.product.github %}.' +intro: Find information to use when managing your subscriptions and notifications on {% data variables.product.github %}. versions: fpt: '*' ghes: '*' @@ -9,4 +9,6 @@ versions: children: - /inbox-filters - /email-notification-headers + - /types-of-emails-github-sends --- + diff --git a/content/account-and-profile/reference/types-of-emails-github-sends.md b/content/subscriptions-and-notifications/reference/types-of-emails-github-sends.md similarity index 90% rename from content/account-and-profile/reference/types-of-emails-github-sends.md rename to content/subscriptions-and-notifications/reference/types-of-emails-github-sends.md index 4b0122eca4d7..4dbdb54671bc 100644 --- a/content/account-and-profile/reference/types-of-emails-github-sends.md +++ b/content/subscriptions-and-notifications/reference/types-of-emails-github-sends.md @@ -1,12 +1,13 @@ --- title: Types of emails GitHub sends -intro: 'There are several types of emails you can receive from {% data variables.product.github %}, including notifications, account information, customer research invitations, and marketing communications.' +intro: There are several types of emails you can receive from {% data variables.product.github %}, including notifications, account information, customer research invitations, and marketing communications. redirect_from: - /articles/types-of-emails-github-sends - /github/setting-up-and-managing-your-github-user-account/types-of-emails-github-sends - /github/setting-up-and-managing-your-github-user-account/managing-email-preferences/types-of-emails-github-sends - /account-and-profile/setting-up-and-managing-your-github-user-account/managing-email-preferences/types-of-emails-github-sends - /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/types-of-emails-github-sends + - /account-and-profile/reference/types-of-emails-github-sends versions: fpt: '*' ghec: '*' @@ -14,6 +15,7 @@ topics: - Accounts - Notifications shortTitle: Emails from GitHub +contentType: reference --- ## Notification emails From 2f78652f55935022737c5e9e402f8288997e6854 Mon Sep 17 00:00:00 2001 From: Evan Bonsignori Date: Fri, 17 Oct 2025 11:49:27 -0700 Subject: [PATCH 2/4] better search scraping error handling (don't fail on single page) (#58004) --- .github/workflows/index-general-search.yml | 26 ++++ .../scripts/scrape/lib/build-records.ts | 125 +++++++++++++++-- src/search/scripts/scrape/lib/domwaiter.ts | 131 +++++++++++++----- .../scrape/lib/scrape-into-index-json.ts | 40 +++++- 4 files changed, 269 insertions(+), 53 deletions(-) diff --git a/.github/workflows/index-general-search.yml b/.github/workflows/index-general-search.yml index ce4abbbef3c0..c3930e1412a0 100644 --- a/.github/workflows/index-general-search.yml +++ b/.github/workflows/index-general-search.yml @@ -180,6 +180,19 @@ jobs: ls -lh /tmp/records + - name: Check for scraping failures + id: check-failures + run: | + if [ -f /tmp/records/failures-summary.json ]; then + FAILED_PAGES=$(jq -r '.totalFailedPages' /tmp/records/failures-summary.json) + echo "failed_pages=$FAILED_PAGES" >> $GITHUB_OUTPUT + echo "has_failures=true" >> $GITHUB_OUTPUT + echo "⚠️ Warning: $FAILED_PAGES page(s) failed to scrape" + else + echo "has_failures=false" >> $GITHUB_OUTPUT + echo "✅ All pages scraped successfully" + fi + - name: Check that Elasticsearch is accessible run: | curl --fail --retry-connrefused --retry 5 -I ${{ env.ELASTICSEARCH_URL }} @@ -211,6 +224,19 @@ jobs: FASTLY_SURROGATE_KEY: api-search:${{ matrix.language }} run: npm run purge-fastly-edge-cache + - name: Alert on scraping failures + if: ${{ steps.check-failures.outputs.has_failures == 'true' && github.event_name != 'workflow_dispatch' }} + uses: ./.github/actions/slack-alert + with: + slack_channel_id: ${{ secrets.DOCS_ALERTS_SLACK_CHANNEL_ID }} + slack_token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }} + message: | + :warning: ${{ steps.check-failures.outputs.failed_pages }} page(s) failed to scrape for general search indexing (language: ${{ matrix.language }}) + + The indexing completed but some pages could not be scraped. This may affect search results for those pages. + + Workflow: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + - uses: ./.github/actions/slack-alert if: ${{ failure() && github.event_name != 'workflow_dispatch' }} with: diff --git a/src/search/scripts/scrape/lib/build-records.ts b/src/search/scripts/scrape/lib/build-records.ts index b2f1d734b1ad..fe082ebd4ce7 100644 --- a/src/search/scripts/scrape/lib/build-records.ts +++ b/src/search/scripts/scrape/lib/build-records.ts @@ -48,6 +48,18 @@ const MIN_TIME = parseInt(process.env.BUILD_RECORDS_MIN_TIME || '200', 10) // when multiple docs match on a certain keyword(s). const FORCE_0_POPULARITY_PRODUCTS = new Set(['contributing']) +interface FailedPage { + url?: string + relativePath?: string + error: string + errorType: string +} + +export interface BuildRecordsResult { + records: Record[] + failedPages: FailedPage[] +} + export default async function buildRecords( indexName: string, indexablePages: Page[], @@ -55,7 +67,7 @@ export default async function buildRecords( languageCode: string, redirects: Redirects, config: Config = {} as Config, -): Promise { +): Promise { // Determine the page version from the index version const pageVersion = getAllVersionsKeyFromIndexVersion(indexVersion) @@ -96,6 +108,9 @@ export default async function buildRecords( const hasPopularPages = Object.keys(popularPages).length > 0 + // Track failed pages + const failedPages: FailedPage[] = [] + const waiter = domwaiter(permalinks, { maxConcurrent: MAX_CONCURRENT, minTime: MIN_TIME }) .on('page', (page) => { if (!noMarkers) process.stdout.write(pageMarker) @@ -114,23 +129,105 @@ export default async function buildRecords( records.push(newRecord) }) .on('error', (err) => { - if (err instanceof HTTPError && !err.response.ok) { - console.log( - '\n' + - boxen(chalk.bold(err.request.requestUrl?.pathname), { - title: chalk.red('The URL it failed on was'), - padding: 1, - borderColor: 'red', - }) + - '\n', - ) + // Track the failure + const url = (err as any).url + const relativePath = (err as any).relativePath + + // Check for HTTPError by name since it may come from a different module + if ((err instanceof HTTPError || err?.name === 'HTTPError') && (err as any).response) { + const httpErr = err as any + failedPages.push({ + url: httpErr.request?.requestUrl?.pathname || url, + relativePath, + error: err.message, + errorType: `HTTP ${httpErr.response?.statusCode || 'Error'}`, + }) + + if (!noMarkers) process.stdout.write(chalk.red('✗')) + } else if (err instanceof Error) { + // Enhanced error handling for timeout and network errors + const errorType = (err.cause as any)?.code || err.name + const isTimeout = + errorType === 'UND_ERR_HEADERS_TIMEOUT' || + errorType === 'UND_ERR_CONNECT_TIMEOUT' || + err.message.includes('timed out') + + failedPages.push({ + url, + relativePath, + error: err.message, + errorType: isTimeout ? 'Timeout' : errorType || 'Unknown Error', + }) + + if (!noMarkers) process.stdout.write(chalk.red('✗')) } else { - console.error(err) + failedPages.push({ + url, + relativePath, + error: String(err), + errorType: 'Unknown Error', + }) + + if (!noMarkers) process.stdout.write(chalk.red('✗')) } }) - return eventToPromise(waiter, 'done').then(() => { + // Wait for 'done' event but ignore 'error' events (they're handled by the error listener above) + return eventToPromise(waiter, 'done', { ignoreErrors: true }).then(() => { console.log('\nrecords in index: ', records.length) - return records + + // Report failed pages if any + if (failedPages.length > 0) { + console.log( + '\n' + + boxen( + chalk.bold.red(`${failedPages.length} page(s) failed to scrape\n\n`) + + failedPages + .slice(0, 10) // Show first 10 failures + .map((failure, idx) => { + return ( + chalk.gray(`${idx + 1}. `) + + chalk.yellow(failure.errorType) + + '\n' + + (failure.relativePath + ? chalk.cyan(` Path: `) + failure.relativePath + '\n' + : '') + + (failure.url ? chalk.cyan(` URL: `) + failure.url + '\n' : '') + + chalk.gray(` Error: ${failure.error}`) + ) + }) + .join('\n\n') + + (failedPages.length > 10 + ? `\n\n${chalk.gray(`... and ${failedPages.length - 10} more`)}` + : ''), + { + title: chalk.red('⚠ Failed Pages'), + padding: 1, + borderColor: 'yellow', + }, + ) + + '\n', + ) + + // Log suggestion + console.log( + chalk.yellow( + `💡 Tip: These failures won't stop the scraping process. The script will continue with the remaining pages.`, + ), + ) + + if (failedPages.some((f) => f.errorType === 'Timeout')) { + console.log( + chalk.gray( + ` For timeout errors, try: export BUILD_RECORDS_MAX_CONCURRENT=50 (currently ${MAX_CONCURRENT})`, + ), + ) + } + } + + return { + records, + failedPages, + } }) } diff --git a/src/search/scripts/scrape/lib/domwaiter.ts b/src/search/scripts/scrape/lib/domwaiter.ts index 2dc28c4dc5a9..2b9c0c6f9138 100644 --- a/src/search/scripts/scrape/lib/domwaiter.ts +++ b/src/search/scripts/scrape/lib/domwaiter.ts @@ -32,6 +32,15 @@ interface DomWaiterOptions { export default function domwaiter(pages: Permalink[], opts: DomWaiterOptions = {}): EventEmitter { const emitter = new EventEmitter() + // Add a default no-op error handler to prevent EventEmitter from throwing + // when errors are emitted before the caller attaches their error handler + // This will be overridden/supplemented by the caller's error handler + const defaultErrorHandler = () => { + // No-op: prevents EventEmitter from throwing + // External handlers will still receive the error + } + emitter.on('error', defaultErrorHandler) + const defaults = { parseDOM: true, json: false, @@ -43,7 +52,12 @@ export default function domwaiter(pages: Permalink[], opts: DomWaiterOptions = { const limiter = new Bottleneck(opts) pages.forEach((page) => { - limiter.schedule(() => getPage(page, emitter, opts)) + limiter + .schedule(() => getPage(page, emitter, opts)) + .catch((err) => { + // Catch any unhandled promise rejections + emitter.emit('error', err) + }) }) limiter.on('idle', () => { @@ -58,46 +72,87 @@ export default function domwaiter(pages: Permalink[], opts: DomWaiterOptions = { } async function getPage(page: Permalink, emitter: EventEmitter, opts: DomWaiterOptions) { - emitter.emit('beforePageLoad', page) + // Wrap everything in a try-catch to ensure no errors escape + try { + emitter.emit('beforePageLoad', page) - if (opts.json) { - try { - const response = await fetchWithRetry(page.url!, undefined, { retries: 3, timeout: 60000 }) - if (!response.ok) { - throw new HTTPError( - `HTTP ${response.status}: ${response.statusText}`, - { ok: response.ok, statusCode: response.status }, - { requestUrl: { pathname: page.url } }, - ) - } - const json = await response.json() - const pageCopy = Object.assign({}, page, { json }) - emitter.emit('page', pageCopy) - } catch (err) { - if (err instanceof Error) { - err.message = `Failed to fetch ${page.url}: ${err.message}` + if (opts.json) { + try { + const response = await fetchWithRetry(page.url!, undefined, { + retries: 3, + throwHttpErrors: false, + timeout: 60000, + }) + if (!response.ok) { + const httpError = new HTTPError( + `HTTP ${response.status}: ${response.statusText}`, + { ok: response.ok, statusCode: response.status }, + { requestUrl: { pathname: page.url } }, + ) + // Add URL and path info directly to the HTTPError + ;(httpError as any).url = page.url + ;(httpError as any).relativePath = page.relativePath + // Emit error instead of throwing + emitter.emit('error', httpError) + return // Exit early, don't continue processing + } + const json = await response.json() + const pageCopy = Object.assign({}, page, { json }) + emitter.emit('page', pageCopy) + } catch (err) { + // Enhance error with URL information + if (err instanceof Error && page.url) { + const enhancedError = new Error(err.message, { cause: err.cause }) + enhancedError.name = err.name + enhancedError.stack = err.stack + ;(enhancedError as any).url = page.url + ;(enhancedError as any).relativePath = page.relativePath + emitter.emit('error', enhancedError) + } else { + emitter.emit('error', err) + } } - emitter.emit('error', err) - } - } else { - try { - const response = await fetchWithRetry(page.url!, undefined, { retries: 3, timeout: 60000 }) - if (!response.ok) { - throw new HTTPError( - `HTTP ${response.status}: ${response.statusText}`, - { ok: response.ok, statusCode: response.status }, - { requestUrl: { pathname: page.url } }, - ) - } - const body = await response.text() - const pageCopy = Object.assign({}, page, { body }) - if (opts.parseDOM) (pageCopy as any).$ = cheerio.load(body) - emitter.emit('page', pageCopy) - } catch (err) { - if (err instanceof Error) { - err.message = `Failed to fetch ${page.url}: ${err.message}` + } else { + try { + const response = await fetchWithRetry(page.url!, undefined, { + retries: 3, + throwHttpErrors: false, + timeout: 60000, + }) + if (!response.ok) { + const httpError = new HTTPError( + `HTTP ${response.status}: ${response.statusText}`, + { ok: response.ok, statusCode: response.status }, + { requestUrl: { pathname: page.url } }, + ) + // Add URL and path info directly to the HTTPError + ;(httpError as any).url = page.url + ;(httpError as any).relativePath = page.relativePath + // Emit error instead of throwing + emitter.emit('error', httpError) + return // Exit early, don't continue processing + } + const body = await response.text() + const pageCopy = Object.assign({}, page, { body }) + if (opts.parseDOM) (pageCopy as any).$ = cheerio.load(body) + emitter.emit('page', pageCopy) + } catch (err) { + // Enhance error with URL information + if (err instanceof Error && page.url) { + const enhancedError = new Error(err.message, { cause: err.cause }) + enhancedError.name = err.name + enhancedError.stack = err.stack + ;(enhancedError as any).url = page.url + ;(enhancedError as any).relativePath = page.relativePath + emitter.emit('error', enhancedError) + } else { + emitter.emit('error', err) + } } - emitter.emit('error', err) } + } catch (err) { + // Ultimate catch-all to ensure nothing escapes + console.error('Unexpected error in getPage:', err) + emitter.emit('error', err) } } diff --git a/src/search/scripts/scrape/lib/scrape-into-index-json.ts b/src/search/scripts/scrape/lib/scrape-into-index-json.ts index 6d4b73733088..ccb1880c3fa6 100644 --- a/src/search/scripts/scrape/lib/scrape-into-index-json.ts +++ b/src/search/scripts/scrape/lib/scrape-into-index-json.ts @@ -45,13 +45,21 @@ export default async function scrapeIntoIndexJson({ }) let countRecordsTotal = 0 + let totalFailedPages = 0 + const allFailures: Array<{ + indexName: string + languageCode: string + indexVersion: string + failures: Array<{ url?: string; relativePath?: string; error: string; errorType: string }> + }> = [] + // Build and validate all indices for (const languageCode of languagesToBuild) { for (const indexVersion of versionsToBuild) { const { indexName } = getElasticSearchIndex('generalSearch', indexVersion, languageCode) // The page version will be the new version, e.g., free-pro-team@latest, enterprise-server@3.7 - const records = await buildRecords( + const { records, failedPages } = await buildRecords( indexName, indexablePages, indexVersion, @@ -60,6 +68,17 @@ export default async function scrapeIntoIndexJson({ config, ) countRecordsTotal += records.length + + if (failedPages.length > 0) { + totalFailedPages += failedPages.length + allFailures.push({ + indexName, + languageCode, + indexVersion, + failures: failedPages, + }) + } + const fileWritten = await writeIndexRecords(indexName, records, outDirectory) console.log(`wrote records to ${fileWritten}`) } @@ -71,6 +90,25 @@ export default async function scrapeIntoIndexJson({ console.log(`Took ${chalk.bold(formatSeconds(tookSec))}`) const rate = (countRecordsTotal / tookSec).toFixed(1) console.log(`Rate ~${chalk.bold(rate)} pages per second.`) + + // Write failures summary to a file for GitHub Actions to read + if (totalFailedPages > 0) { + const fs = await import('fs') + const path = await import('path') + const failuresSummaryPath = path.join(outDirectory, 'failures-summary.json') + await fs.promises.writeFile( + failuresSummaryPath, + JSON.stringify( + { + totalFailedPages, + failures: allFailures, + }, + null, + 2, + ), + ) + console.log(`\n${chalk.yellow('⚠')} Wrote failures summary to ${failuresSummaryPath}`) + } } function formatSeconds(seconds: number): string { From 6f87d90a06b1c0ad37cb688c27237653a44a5a06 Mon Sep 17 00:00:00 2001 From: Robert Sese <734194+rsese@users.noreply.github.com> Date: Fri, 17 Oct 2025 14:31:36 -0500 Subject: [PATCH 3/4] Article grid tests (#58036) --- .../grid-category-one/grid-article-one.md | 14 ++ .../grid-category-one/grid-article-two.md | 14 ++ .../grid-category-one/index.md | 13 ++ .../grid-category-two/grid-article-four.md | 14 ++ .../grid-category-two/grid-article-three.md | 14 ++ .../grid-category-two/index.md | 13 ++ .../get-started/article-grid-bespoke/index.md | 25 +++ .../grid-category-one/grid-article-one.md | 14 ++ .../grid-category-one/grid-article-two.md | 14 ++ .../grid-category-one/index.md | 13 ++ .../grid-category-two/grid-article-four.md | 14 ++ .../grid-category-two/grid-article-three.md | 14 ++ .../grid-category-two/index.md | 13 ++ .../article-grid-discovery/index.md | 25 +++ .../fixtures/content/get-started/index.md | 2 + .../tests/playwright-rendering.spec.ts | 153 ++++++++++++++++++ .../shared/LandingArticleGridWithFilter.tsx | 9 +- 17 files changed, 374 insertions(+), 4 deletions(-) create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-one.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-two.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/index.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-four.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-three.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/index.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-bespoke/index.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-one.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-two.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/index.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-four.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-three.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/index.md create mode 100644 src/fixtures/fixtures/content/get-started/article-grid-discovery/index.md diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-one.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-one.md new file mode 100644 index 000000000000..b1b4851d47d5 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-one.md @@ -0,0 +1,14 @@ +--- +title: Grid Article One +intro: "This is the first test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Getting started + - Frontend +layout: inline +--- + +This is the content of the first test article for the ArticleGrid component. It demonstrates how the grid displays articles with search and filtering functionality. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-two.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-two.md new file mode 100644 index 000000000000..fb763ccaddf0 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/grid-article-two.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Two +intro: "This is the second test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Getting started + - Backend +layout: inline +--- + +This is the content of the second test article for the ArticleGrid component. It helps test the filtering and pagination features. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/index.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/index.md new file mode 100644 index 000000000000..a0b9e5135044 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-one/index.md @@ -0,0 +1,13 @@ +--- +title: Grid Category One +intro: "First category of test articles for article grid." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +children: + - /grid-article-one + - /grid-article-two +--- + +This is the first category of test articles for the ArticleGrid component. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-four.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-four.md new file mode 100644 index 000000000000..396d745ffd87 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-four.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Four +intro: "This is the fourth test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Advanced + - Testing +layout: inline +--- + +This is the content of the fourth test article for the ArticleGrid component. It demonstrates search functionality and responsive grid layout. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-three.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-three.md new file mode 100644 index 000000000000..f9937d133e66 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/grid-article-three.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Three +intro: "This is the third test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Advanced + - API +layout: inline +--- + +This is the content of the third test article for the ArticleGrid component. It allows testing of category filtering and responsive behavior. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/index.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/index.md new file mode 100644 index 000000000000..d9a013d5a761 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/grid-category-two/index.md @@ -0,0 +1,13 @@ +--- +title: Grid Category Two +intro: "Second category of test articles for article grid." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +children: + - /grid-article-three + - /grid-article-four +--- + +This is the second category of test articles for the ArticleGrid component. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-bespoke/index.md b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/index.md new file mode 100644 index 000000000000..939c6507c921 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-bespoke/index.md @@ -0,0 +1,25 @@ +--- +title: Article Grid Bespoke Landing +intro: "A test page for testing the LandingArticleGridWithFilter component with bespoke landing layout." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +layout: bespoke-landing +recommended: + - /grid-category-one/grid-article-one + - /grid-category-one/grid-article-two + - /grid-category-two/grid-article-three +spotlight: + - article: /grid-category-one/grid-article-one + image: /assets/images/placeholder.png + - article: /grid-category-one/grid-article-two + image: /assets/images/placeholder.png + - article: /grid-category-two/grid-article-three + image: /assets/images/placeholder.png +children: + - /grid-category-one + - /grid-category-two +--- + +This page tests the LandingArticleGridWithFilter component with bespoke landing layout. \ No newline at end of file diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-one.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-one.md new file mode 100644 index 000000000000..b1b4851d47d5 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-one.md @@ -0,0 +1,14 @@ +--- +title: Grid Article One +intro: "This is the first test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Getting started + - Frontend +layout: inline +--- + +This is the content of the first test article for the ArticleGrid component. It demonstrates how the grid displays articles with search and filtering functionality. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-two.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-two.md new file mode 100644 index 000000000000..fb763ccaddf0 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/grid-article-two.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Two +intro: "This is the second test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Getting started + - Backend +layout: inline +--- + +This is the content of the second test article for the ArticleGrid component. It helps test the filtering and pagination features. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/index.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/index.md new file mode 100644 index 000000000000..a0b9e5135044 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-one/index.md @@ -0,0 +1,13 @@ +--- +title: Grid Category One +intro: "First category of test articles for article grid." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +children: + - /grid-article-one + - /grid-article-two +--- + +This is the first category of test articles for the ArticleGrid component. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-four.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-four.md new file mode 100644 index 000000000000..396d745ffd87 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-four.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Four +intro: "This is the fourth test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Advanced + - Testing +layout: inline +--- + +This is the content of the fourth test article for the ArticleGrid component. It demonstrates search functionality and responsive grid layout. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-three.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-three.md new file mode 100644 index 000000000000..f9937d133e66 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/grid-article-three.md @@ -0,0 +1,14 @@ +--- +title: Grid Article Three +intro: "This is the third test article for the article grid component." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +category: + - Advanced + - API +layout: inline +--- + +This is the content of the third test article for the ArticleGrid component. It allows testing of category filtering and responsive behavior. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/index.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/index.md new file mode 100644 index 000000000000..d9a013d5a761 --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/grid-category-two/index.md @@ -0,0 +1,13 @@ +--- +title: Grid Category Two +intro: "Second category of test articles for article grid." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +children: + - /grid-article-three + - /grid-article-four +--- + +This is the second category of test articles for the ArticleGrid component. diff --git a/src/fixtures/fixtures/content/get-started/article-grid-discovery/index.md b/src/fixtures/fixtures/content/get-started/article-grid-discovery/index.md new file mode 100644 index 000000000000..8944b2da5cea --- /dev/null +++ b/src/fixtures/fixtures/content/get-started/article-grid-discovery/index.md @@ -0,0 +1,25 @@ +--- +title: Article Grid Discovery +intro: "A test page for testing the LandingArticleGridWithFilter component with discovery landing layout." +versions: + fpt: "*" + ghes: "*" + ghec: "*" +layout: discovery-landing +recommended: + - /grid-category-one/grid-article-one + - /grid-category-one/grid-article-two + - /grid-category-two/grid-article-three +spotlight: + - article: /grid-category-one/grid-article-one + image: /assets/images/placeholder.png + - article: /grid-category-one/grid-article-two + image: /assets/images/placeholder.png + - article: /grid-category-two/grid-article-three + image: /assets/images/placeholder.png +children: + - /grid-category-one + - /grid-category-two +--- + +This page tests the LandingArticleGridWithFilter component with discovery landing layout. \ No newline at end of file diff --git a/src/fixtures/fixtures/content/get-started/index.md b/src/fixtures/fixtures/content/get-started/index.md index f8a3aa3b47fb..c96cdc006024 100644 --- a/src/fixtures/fixtures/content/get-started/index.md +++ b/src/fixtures/fixtures/content/get-started/index.md @@ -42,6 +42,8 @@ children: - /learning-about-github - /empty-categories - /carousel + - /article-grid-discovery + - /article-grid-bespoke communityRedirect: name: Provide HubGit Feedback href: 'https://hubgit.com/orgs/community/discussions/categories/get-started' diff --git a/src/fixtures/tests/playwright-rendering.spec.ts b/src/fixtures/tests/playwright-rendering.spec.ts index 9c65a35ab786..a3e50b8f64fe 100644 --- a/src/fixtures/tests/playwright-rendering.spec.ts +++ b/src/fixtures/tests/playwright-rendering.spec.ts @@ -1155,3 +1155,156 @@ test.describe('Journey Tracks', () => { } }) }) + +test.describe('LandingArticleGridWithFilter component', () => { + test('displays article grid with filter controls', async ({ page }) => { + await page.goto('/get-started/article-grid-discovery') + + // Check that the main components are visible, title, categories drop + // down, search input. + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + + const filterHeader = page.getByTestId('filter-header') + await expect(filterHeader).toBeVisible() + + const title = page.locator('h2').filter({ hasText: 'Articles' }) + await expect(title).toBeVisible() + + const categoryDropdown = page.getByRole('button').filter({ hasText: 'All categories' }) + await expect(categoryDropdown).toBeVisible() + + const searchInput = page.getByPlaceholder('Search articles') + await expect(searchInput).toBeVisible() + }) + + test('displays article cards with correct content', async ({ page }) => { + await page.goto('/get-started/article-grid-discovery') + + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + + // Check that article cards are present and they have expected structure + // by checking the first card. + const articleCards = articleGrid.getByTestId('article-card') + await expect(articleCards.first()).toBeVisible() + + const firstCard = articleCards.first() + const titleLink = firstCard.locator('h3 a') + await expect(titleLink).toBeVisible() + + const intro = firstCard.locator('div').last() // cardIntro is the last div + await expect(intro).toBeVisible() + const introText = await intro.textContent() + expect(introText).toBeTruthy() + + // Card should have categories, title, and intro, just check the card has + // some text + const cardText = await firstCard.textContent() + expect(cardText).toBeTruthy() + expect(cardText!.length).toBeGreaterThan(0) + }) + + test('category filtering works correctly', async ({ page }) => { + await page.goto('/get-started/article-grid-discovery') + + // Check that category dropdown button exists and is clickable + const categoryDropdown = page.getByRole('button').filter({ hasText: 'All categories' }) + await expect(categoryDropdown).toBeVisible() + + // Initially should show all articles (4 total in our fixtures) + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + const allArticleCards = articleGrid.getByTestId('article-card') + await expect(allArticleCards).toHaveCount(4) + + // Click the dropdown and the 'Testing' category + await categoryDropdown.click() + const testingOption = page.getByText('Testing', { exact: true }).last() + await expect(testingOption).toBeVisible() + await testingOption.click() + + // After filtering by Testing category, should show only 1 article based + // on our fixtures. + await expect(allArticleCards).toHaveCount(1) + + // Verify the filtered article contains "Testing" somewhere in its markup + const remainingCard = allArticleCards.first() + await expect(remainingCard).toContainText('Testing') + }) + + test('search functionality works', async ({ page }) => { + await page.goto('/get-started/article-grid-discovery') + + const searchInput = page.getByPlaceholder('Search articles') + await expect(searchInput).toBeVisible() + + // Initially should show all articles (4 total in our fixtures) + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + + const articleCards = articleGrid.getByTestId('article-card') + await expect(articleCards).toHaveCount(4) + + // Search for "Grid" - based on our fixtures, multiple articles should have "Grid" in their names + await searchInput.fill('Grid') + await expect(articleCards.first()).toBeVisible() + + // Verify that the remaining articles contain "Grid" in their content + const remainingCount = await articleCards.count() + expect(remainingCount).toBeGreaterThan(0) + for (let i = 0; i < remainingCount; i++) { + const card = articleCards.nth(i) + await expect(card).toContainText('Grid') + } + }) + + test('search with no results shows appropriate message', async ({ page }) => { + await page.goto('/get-started/article-grid-discovery') + + const searchInput = page.getByPlaceholder('Search articles') + await expect(searchInput).toBeVisible() + + // Search for a term that definitely won't match any articles, should show + // no article cards + await searchInput.fill('noSuchArticles') + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + const articleCards = articleGrid.getByTestId('article-card') + await expect(articleCards).toHaveCount(0) + + // Should show "no articles found" message as well + const noResultsMessage = page.getByTestId('no-articles-message') + await expect(noResultsMessage).toBeVisible() + }) + + test('responsive behavior on different screen sizes', async ({ page }) => { + // Super basic test, just make sure the article grid is visible on + // different viewports sizes + + // Test desktop view (3 columns) + await page.setViewportSize({ width: 1200, height: 800 }) + await page.goto('/get-started/article-grid-discovery') + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + + // Test tablet view (2 columns) + await page.setViewportSize({ width: 768, height: 1024 }) + await page.waitForTimeout(100) // Brief wait for responsive changes + await expect(articleGrid).toBeVisible() + + // Test mobile view (1 column) + await page.setViewportSize({ width: 375, height: 667 }) + await page.waitForTimeout(100) // Brief wait for responsive changes + await expect(articleGrid).toBeVisible() + }) + + test('works with bespoke landing page', async ({ page }) => { + // Other grid tests use the discovery landing page, bespoke pages are + // similar so just do a quick check. + await page.goto('/get-started/article-grid-bespoke') + + const articleGrid = page.getByTestId('article-grid') + await expect(articleGrid).toBeVisible() + }) +}) diff --git a/src/landings/components/shared/LandingArticleGridWithFilter.tsx b/src/landings/components/shared/LandingArticleGridWithFilter.tsx index 4ab780fe3708..4b57ef1485f0 100644 --- a/src/landings/components/shared/LandingArticleGridWithFilter.tsx +++ b/src/landings/components/shared/LandingArticleGridWithFilter.tsx @@ -116,9 +116,9 @@ export const ArticleGrid = ({ flatArticles }: ArticleGridProps) => { } return ( -
+
{/* Filter and Search Controls */} -
+
{/* Title and Dropdown Row */}
{/* Title */} @@ -170,12 +170,12 @@ export const ArticleGrid = ({ flatArticles }: ArticleGridProps) => {
{/* Results Grid */} -
+
{paginatedResults.map((article, index) => ( ))} {filteredResults.length === 0 && ( -
+

{t('article_grid.no_articles_found')}

)} @@ -218,6 +218,7 @@ const ArticleCard = ({ article }: ArticleCardProps) => { 'border-default', 'rounded-2', )} + data-testid="article-card" >
{article.category && From 1d656a97919f35f26687b686a313af4075ab2865 Mon Sep 17 00:00:00 2001 From: Ankit Honey Date: Fri, 17 Oct 2025 13:31:23 -0700 Subject: [PATCH 4/4] update dependabot default label (#58032) Co-authored-by: Jeff Widman Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> Co-authored-by: Carlin Cherry <61124041+carlincherry@users.noreply.github.com> --- data/reusables/dependabot/default-labels.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data/reusables/dependabot/default-labels.md b/data/reusables/dependabot/default-labels.md index 000db286ca49..7737204eb7af 100644 --- a/data/reusables/dependabot/default-labels.md +++ b/data/reusables/dependabot/default-labels.md @@ -1,5 +1,5 @@ -By default, {% data variables.product.prodname_dependabot %} raises all pull requests with the `dependencies` label. +By default, {% data variables.product.prodname_dependabot %} raises pull requests with the `dependencies` label. -If more than one package manager is defined, {% data variables.product.prodname_dependabot %} includes an additional label on each pull request, which indicates which language or ecosystem the pull request updates. For example, adding `java` for Gradle updates, or `submodules` for git submodule updates. +{% data variables.product.prodname_dependabot %} also applies an ecosystem label, such as `java`, `npm`, or `github-actions`, to pull requests. {% data variables.product.prodname_dependabot %} adds both the `dependencies` label and the ecosystem label to all pull requests, including single-ecosystem updates, to improve filtering and triaging. -{% data variables.product.prodname_dependabot %} creates the default labels it applies to pull requests if they do not already exist in the repository. If you want to use custom labels, you need to create these yourself. For more information, see: [AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels). +{% data variables.product.prodname_dependabot %} creates the default labels it applies to pull requests if they do not already exist in the repository. If you want to use custom labels instead of the defaults, you can set the `labels` option in your `dependabot.yml` file per package ecosystem; this overrides the defaults. For more information, see [AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels) and [`labels`](/code-security/dependabot/working-with-dependabot/dependabot-options-reference#labels--).