From 2548f7d9ec1f6532845a3901fc3143588a070bce Mon Sep 17 00:00:00 2001 From: Joe Clark <31087804+jc-clark@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:17:30 -0700 Subject: [PATCH] [EDI] Create new "Subscriptions and notifications" landing page and get started map topic (#56950) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- content/account-and-profile/index.md | 9 ++------- .../setting-up-notifications/index.md | 17 ----------------- content/index.md | 2 ++ .../concepts}/about-notifications.md | 2 ++ .../concepts/index.md | 14 ++++++++++++++ .../get-started}/configuring-notifications.md | 2 ++ .../get-started/index.md | 16 ++++++++++++++++ .../how-tos/index.md | 13 +++++++++++++ .../index.md | 3 +++ .../managing-your-subscriptions.md | 4 +++- .../viewing-your-subscriptions.md | 2 ++ .../index.md | 3 ++- .../managing-notifications-from-your-inbox.md | 4 +++- .../triaging-a-single-notification.md | 2 ++ .../index.md | 19 +++++++++++++++---- ...orkflow-for-triaging-your-notifications.md | 2 ++ .../tutorials/index.md | 13 +++++++++++++ 17 files changed, 96 insertions(+), 31 deletions(-) delete mode 100644 content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/index.md rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications => subscriptions-and-notifications/concepts}/about-notifications.md (97%) create mode 100644 content/subscriptions-and-notifications/concepts/index.md rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications => subscriptions-and-notifications/get-started}/configuring-notifications.md (99%) create mode 100644 content/subscriptions-and-notifications/get-started/index.md create mode 100644 content/subscriptions-and-notifications/how-tos/index.md rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/managing-subscriptions-for-activity-on-github/index.md (69%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md (92%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md (96%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/viewing-and-triaging-notifications/index.md (74%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md (96%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications/how-tos}/viewing-and-triaging-notifications/triaging-a-single-notification.md (91%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github => subscriptions-and-notifications}/index.md (52%) rename content/{account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications => subscriptions-and-notifications/tutorials}/customizing-a-workflow-for-triaging-your-notifications.md (95%) create mode 100644 content/subscriptions-and-notifications/tutorials/index.md diff --git a/content/account-and-profile/index.md b/content/account-and-profile/index.md index 04daff7c50..d570cda13b 100644 --- a/content/account-and-profile/index.md +++ b/content/account-and-profile/index.md @@ -1,7 +1,7 @@ --- title: Account and profile documentation shortTitle: Account and profile -intro: 'Make {% data variables.product.github %} work best for you by customizing your personal account settings, personalizing your profile page, and managing the notifications you receive.' +intro: 'Make {% data variables.product.github %} work best for you by customizing your personal account settings and personalizing your profile page.' introLinks: quickstart: - /get-started/onboarding/getting-started-with-your-github-account @@ -9,18 +9,15 @@ featuredLinks: startHere: - /account-and-profile/concepts/changing-your-github-username - /account-and-profile/how-tos/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme - - /account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications 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/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications guideCards: - /account-and-profile/reference/why-are-my-contributions-not-showing-up-on-my-profile - - /account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox - /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 - '{% ifversion ghes %}/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-the-default-branch-name-for-your-repositories{% endif %}' changelog: - label: 'profiles, github-themes, notifications' + label: 'profiles, github-themes' versions: fpt: '*' ghec: '*' @@ -32,13 +29,11 @@ versions: topics: - Accounts - Profiles - - Notifications children: - /get-started - /concepts - /how-tos - /tutorials - /reference - - /managing-subscriptions-and-notifications-on-github --- diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/index.md b/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/index.md deleted file mode 100644 index 0b721155af..0000000000 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Setting up notifications -intro: 'To improve the relevance of your notifications and simplify your triaging workflow, set up your notifications to match your priorities.' -redirect_from: - - /articles/getting-started-with-notifications - - /github/managing-subscriptions-and-notifications-on-github/setting-up-notifications -versions: - fpt: '*' - ghes: '*' - ghec: '*' -topics: - - Notifications -children: - - /about-notifications - - /configuring-notifications ---- - diff --git a/content/index.md b/content/index.md index cc7640f0ab..312655e452 100644 --- a/content/index.md +++ b/content/index.md @@ -53,6 +53,7 @@ children: - get-started - enterprise-onboarding - account-and-profile + - subscriptions-and-notifications - authentication - repositories - admin @@ -92,6 +93,7 @@ childGroups: - get-started - migrations - account-and-profile + - subscriptions-and-notifications - authentication - billing - site-policy diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md b/content/subscriptions-and-notifications/concepts/about-notifications.md similarity index 97% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md rename to content/subscriptions-and-notifications/concepts/about-notifications.md index 80135dd6f5..8a97b52970 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications.md +++ b/content/subscriptions-and-notifications/concepts/about-notifications.md @@ -7,6 +7,8 @@ redirect_from: - /github/managing-subscriptions-and-notifications-on-github/about-notifications-beta - /github/managing-subscriptions-and-notifications-on-github/about-notifications - /github/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications + - /account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications + - /subscriptions-and-notifications/setting-up-notifications/about-notifications versions: fpt: '*' ghes: '*' diff --git a/content/subscriptions-and-notifications/concepts/index.md b/content/subscriptions-and-notifications/concepts/index.md new file mode 100644 index 0000000000..3a8f71d5b2 --- /dev/null +++ b/content/subscriptions-and-notifications/concepts/index.md @@ -0,0 +1,14 @@ +--- +title: Concepts for your GitHub notifications +shortTitle: Concepts +intro: 'Learn the core concepts for your {% data variables.product.github %} notifications and subscriptions.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +topics: + - Notifications +children: + - /about-notifications +--- + diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md b/content/subscriptions-and-notifications/get-started/configuring-notifications.md similarity index 99% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md rename to content/subscriptions-and-notifications/get-started/configuring-notifications.md index 83e451003d..48020aeffa 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications.md +++ b/content/subscriptions-and-notifications/get-started/configuring-notifications.md @@ -15,6 +15,8 @@ redirect_from: - /articles/choosing-the-types-of-notifications-you-receive - /github/managing-subscriptions-and-notifications-on-github/configuring-notifications - /github/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications + - /account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications + - /subscriptions-and-notifications/setting-up-notifications/configuring-notifications versions: fpt: '*' ghes: '*' diff --git a/content/subscriptions-and-notifications/get-started/index.md b/content/subscriptions-and-notifications/get-started/index.md new file mode 100644 index 0000000000..7d5350d362 --- /dev/null +++ b/content/subscriptions-and-notifications/get-started/index.md @@ -0,0 +1,16 @@ +--- +title: Get started with your GitHub subscriptions and notifications +shortTitle: Get started +intro: 'Learn about configuring your {% data variables.product.github %} notifications and subscriptions.' +redirect_from: + - /articles/getting-started-with-notifications + - /github/managing-subscriptions-and-notifications-on-github/setting-up-notifications + - /account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications + - /subscriptions-and-notifications/setting-up-notifications +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /configuring-notifications +--- diff --git a/content/subscriptions-and-notifications/how-tos/index.md b/content/subscriptions-and-notifications/how-tos/index.md new file mode 100644 index 0000000000..fe3207c7b6 --- /dev/null +++ b/content/subscriptions-and-notifications/how-tos/index.md @@ -0,0 +1,13 @@ +--- +title: How-tos for your GitHub notifications +shortTitle: How-tos +intro: 'Learn how to accomplish specific tasks for your {% data variables.product.github %} notifications.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /managing-subscriptions-for-activity-on-github + - /viewing-and-triaging-notifications +--- + diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/index.md b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/index.md similarity index 69% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/index.md rename to content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/index.md index f091a3dbab..a85a0f9592 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/index.md +++ b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/index.md @@ -3,6 +3,8 @@ title: Managing subscriptions for activity on GitHub intro: 'To maintain sustainable notification workflows, understand and regularly review your subscriptions.' redirect_from: - /github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github + - /account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github + - /subscriptions-and-notifications/managing-subscriptions-for-activity-on-github versions: fpt: '*' ghes: '*' @@ -14,3 +16,4 @@ children: - /managing-your-subscriptions shortTitle: Manage subscriptions --- + diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md similarity index 92% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md rename to content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md index a3f3e55c76..cf3a2cd6eb 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md +++ b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/managing-your-subscriptions.md @@ -10,9 +10,11 @@ topics: redirect_from: - /github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions - /github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions + - /account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/managing-your-subscriptions + - /subscriptions-and-notifications/managing-subscriptions-for-activity-on-github/managing-your-subscriptions shortTitle: Manage your subscriptions --- -To help you understand your subscriptions and decide whether to unsubscribe, see [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions). +To help you understand your subscriptions and decide whether to unsubscribe, see [AUTOTITLE](/subscriptions-and-notifications/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions). > [!NOTE] > Instead of unsubscribing, you have the option to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% ifversion fpt or ghec %}If you're experiencing abuse and want to ignore a repository, please visit {% data variables.contact.contact_support_page %} so we can help. {% data reusables.policies.abuse %}{% endif %} diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md similarity index 96% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md rename to content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md index f7de2239d0..2308df87bc 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md +++ b/content/subscriptions-and-notifications/how-tos/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions.md @@ -16,6 +16,8 @@ redirect_from: - /articles/listing-the-repositories-youre-watching - /github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions - /github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions + - /account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions + - /subscriptions-and-notifications/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions versions: fpt: '*' ghes: '*' diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/index.md b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/index.md similarity index 74% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/index.md rename to content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/index.md index dfef6a9d2e..0e9c2e7c70 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/index.md +++ b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/index.md @@ -5,6 +5,8 @@ redirect_from: - /articles/managing-notifications - /articles/managing-your-notifications - /github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications + - /account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications + - /subscriptions-and-notifications/viewing-and-triaging-notifications versions: fpt: '*' ghes: '*' @@ -14,7 +16,6 @@ topics: children: - /managing-notifications-from-your-inbox - /triaging-a-single-notification - - /customizing-a-workflow-for-triaging-your-notifications shortTitle: Customize a workflow --- diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md similarity index 96% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md rename to content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md index 2783eb0804..91046bcd80 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md +++ b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/managing-notifications-from-your-inbox.md @@ -1,11 +1,13 @@ --- title: Managing notifications from your inbox -intro: 'Use your inbox to quickly triage and sync your notifications across email and mobile.' +intro: Use your inbox to quickly triage and sync your notifications across email and mobile. redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later - /github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox - /github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox + - /account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/managing-notifications-from-your-inbox + - /subscriptions-and-notifications/viewing-and-triaging-notifications/managing-notifications-from-your-inbox versions: fpt: '*' ghes: '*' diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/triaging-a-single-notification.md b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/triaging-a-single-notification.md similarity index 91% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/triaging-a-single-notification.md rename to content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/triaging-a-single-notification.md index ac539ed2de..e22403ef28 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/triaging-a-single-notification.md +++ b/content/subscriptions-and-notifications/how-tos/viewing-and-triaging-notifications/triaging-a-single-notification.md @@ -10,6 +10,8 @@ topics: redirect_from: - /github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification - /github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/triaging-a-single-notification + - /account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/triaging-a-single-notification + - /subscriptions-and-notifications/viewing-and-triaging-notifications/triaging-a-single-notification shortTitle: Triage a notification --- ## Saving a single notification diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/index.md b/content/subscriptions-and-notifications/index.md similarity index 52% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/index.md rename to content/subscriptions-and-notifications/index.md index a39e5a103f..97095b981c 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/index.md +++ b/content/subscriptions-and-notifications/index.md @@ -1,11 +1,20 @@ --- -title: Managing subscriptions and notifications on GitHub +title: Subscriptions and notifications documentation intro: 'You can specify how to receive notifications, the repositories you are interested in, and the types of activity you want to hear about.' redirect_from: - /categories/76/articles - /categories/notifications - /categories/receiving-notifications-about-activity-on-github - /github/managing-subscriptions-and-notifications-on-github + - /account-and-profile/managing-subscriptions-and-notifications-on-github +layout: product-landing +featuredLinks: + startHere: + - /subscriptions-and-notifications/concepts/about-notifications + popular: + - /subscriptions-and-notifications/get-started/configuring-notifications +changelog: + label: notifications versions: fpt: '*' ghes: '*' @@ -13,8 +22,10 @@ versions: topics: - Notifications children: - - /setting-up-notifications - - /viewing-and-triaging-notifications - - /managing-subscriptions-for-activity-on-github + - /get-started + - /concepts + - /how-tos + - /tutorials shortTitle: Subscriptions & notifications --- + diff --git a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications.md b/content/subscriptions-and-notifications/tutorials/customizing-a-workflow-for-triaging-your-notifications.md similarity index 95% rename from content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications.md rename to content/subscriptions-and-notifications/tutorials/customizing-a-workflow-for-triaging-your-notifications.md index e2987bee5c..49fdf8b323 100644 --- a/content/account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications.md +++ b/content/subscriptions-and-notifications/tutorials/customizing-a-workflow-for-triaging-your-notifications.md @@ -10,6 +10,8 @@ topics: redirect_from: - /github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications - /github/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications + - /account-and-profile/managing-subscriptions-and-notifications-on-github/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications + - /subscriptions-and-notifications/viewing-and-triaging-notifications/customizing-a-workflow-for-triaging-your-notifications shortTitle: Triage your notifications --- ## Starting your inbox triage diff --git a/content/subscriptions-and-notifications/tutorials/index.md b/content/subscriptions-and-notifications/tutorials/index.md new file mode 100644 index 0000000000..a4653960d2 --- /dev/null +++ b/content/subscriptions-and-notifications/tutorials/index.md @@ -0,0 +1,13 @@ +--- +title: Tutorials for your GitHub notifications +shortTitle: Tutorials +intro: 'Build skills and knowledge about your {% data variables.product.github %} notifications.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +topics: + - Notifications +children: + - /customizing-a-workflow-for-triaging-your-notifications +---