Add discovery landing page for desktop docs (#60285)

jc-clark · web-flow · commit f2fb6b5d9b05 · 2026-03-18T20:28:48.000Z
diff --git a/content/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop.md b/content/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Add a repository
+category:
+  - Add and clone repositories
 ---
 
 > [!TIP]
diff --git a/content/desktop/adding-and-cloning-repositories/adding-an-existing-project-to-github-using-github-desktop.md b/content/desktop/adding-and-cloning-repositories/adding-an-existing-project-to-github-using-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Add an existing project
+category:
+  - Add and clone repositories
 ---
 
 {% data reusables.git.remove-git-remote %}
diff --git a/content/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop.md b/content/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Clone a GitHub repo
+category:
+  - Add and clone repositories
 ---
 
 > [!TIP]
diff --git a/content/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop.md b/content/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Clone & fork from Desktop
+category:
+  - Add and clone repositories
 ---
 ## About local repositories
 
diff --git a/content/desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop.md b/content/desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Configure and customize GitHub Desktop
 ---
 When you install {% data variables.product.prodname_desktop %}, {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) is installed, too. {% data variables.large_files.product_name_short %} lets you push files to {% data variables.product.prodname_dotcom %} that exceed the normal limit of {% data variables.large_files.max_github_size %}. For more information about {% data variables.large_files.product_name_short %}, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/about-git-large-file-storage).
 
diff --git a/content/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop.md b/content/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Configure default editor
+category:
+  - Configure and customize GitHub Desktop
 ---
 
 ## Introduction
diff --git a/content/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop.md b/content/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Configure basic settings
+category:
+  - Configure and customize GitHub Desktop
 ---
 {% mac %}
 
diff --git a/content/desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop.md b/content/desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Configure and customize GitHub Desktop
 ---
 ## About Git configuration for {% data variables.product.prodname_desktop %}
 
diff --git a/content/desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop.md b/content/desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Set a theme
+category:
+  - Configure and customize GitHub Desktop
 ---
 {% mac %}
 
diff --git a/content/desktop/index.md b/content/desktop/index.md
@@ -1,31 +1,32 @@
 ---
-title: "{% data variables.product.prodname_desktop %} documentation"
-shortTitle: "{% data variables.product.prodname_desktop %}"
-intro: "With {% data variables.product.prodname_desktop %}, you can interact with GitHub using a GUI instead of the command line or a web browser. You can use GitHub Desktop to complete most Git commands from your desktop, such as pushing to, pulling from, and cloning remote repositories, attributing commits, and creating pull requests, with visual confirmation of changes."
+title: '{% data variables.product.prodname_desktop %} documentation'
+shortTitle: '{% data variables.product.prodname_desktop %}'
+intro: 'With {% data variables.product.prodname_desktop %}, you can interact with GitHub using a GUI instead of the command line or a web browser. You can use GitHub Desktop to complete most Git commands from your desktop, such as pushing to, pulling from, and cloning remote repositories, attributing commits, and creating pull requests, with visual confirmation of changes.'
 introLinks:
   overview: /desktop/overview/about-github-desktop
   quickstart: /desktop/overview/getting-started-with-github-desktop
-featuredLinks:
-  startHere:
+includedCategories:
+  - Set up GitHub Desktop
+  - Configure and customize GitHub Desktop
+  - Add and clone repositories
+  - Work with branches and pull requests
+  - Manage commits
+carousels:
+  recommended:
+    - /desktop/overview/getting-started-with-github-desktop
+    - /desktop/overview/about-github-desktop
     - /desktop/overview/creating-your-first-repository-using-github-desktop
-    - /desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop
-    - /desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop
-  guideCards:
-    - /desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop
-    - /desktop/managing-commits/reverting-a-commit-in-github-desktop
-    - /desktop/managing-commits/amending-a-commit-in-github-desktop
-    - /desktop/managing-commits/cherry-picking-a-commit-in-github-desktop
-  popular:
     - /desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop
+    - /desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop
     - /desktop/making-changes-in-a-branch/managing-branches-in-github-desktop
-    - /desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop
-    - /desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop
     - /desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop
+    - /desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop
+    - /desktop/managing-commits/options-for-managing-commits-in-github-desktop
 changelog:
   label: desktop
   versions:
     feature: desktop
-layout: product-landing
+layout: discovery-landing
 versions:
   feature: desktop
 children:
@@ -41,4 +42,3 @@ redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop
   - /desktop/installing-and-configuring-github-desktop
 ---
-
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/about-connections-to-github-in-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/about-connections-to-github-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: About connections
+category:
+  - Set up GitHub Desktop
 ---
 {% data variables.product.prodname_desktop %} connects to {% data variables.product.prodname_dotcom %} when you pull from, push to, clone, and fork remote repositories. To connect to {% data variables.product.prodname_dotcom %} from {% data variables.product.prodname_desktop %}, you must authenticate your account. For more information, see [AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop).
 
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop.md
@@ -12,6 +12,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Set up GitHub Desktop
 ---
 ## About authentication
 
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Set up GitHub Desktop
 ---
 
 <a href="https://desktop.github.com?ref_product=desktop&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Download {% data variables.product.prodname_desktop %}</span> {% octicon "link-external" height:16 aria-label="link-external" %}</a>
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Set up GitHub Desktop
 ---
 ## Part 1: Installing {% data variables.product.prodname_desktop %}
 
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/uninstalling-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/uninstalling-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Uninstalling
+category:
+  - Set up GitHub Desktop
 ---
 {% mac %}
 
diff --git a/content/desktop/installing-and-authenticating-to-github-desktop/updating-github-desktop.md b/content/desktop/installing-and-authenticating-to-github-desktop/updating-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Set up GitHub Desktop
 ---
 
 {% mac %}
diff --git a/content/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop.md b/content/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Commit & review changes
+category:
+  - Work with branches and pull requests
 ---
 ## About commits
 
diff --git a/content/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop.md b/content/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop.md
@@ -13,6 +13,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Work with branches and pull requests
 ---
 ## About managing branches
 
diff --git a/content/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop.md b/content/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop.md
@@ -12,6 +12,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Work with branches and pull requests
 ---
 ## About pushing changes to {% data variables.product.prodname_dotcom %}
 
diff --git a/content/desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop.md b/content/desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop.md
@@ -10,6 +10,8 @@ redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/stashing-changes
   - /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes
   - /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop
+category:
+  - Work with branches and pull requests
 ---
 ## About stashed changes
 
diff --git a/content/desktop/making-changes-in-a-branch/viewing-the-branch-history-in-github-desktop.md b/content/desktop/making-changes-in-a-branch/viewing-the-branch-history-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: View branch history
+category:
+  - Work with branches and pull requests
 ---
 Each commit shows:
 
diff --git a/content/desktop/making-changes-in-a-branch/working-with-git-hooks-in-github-desktop.md b/content/desktop/making-changes-in-a-branch/working-with-git-hooks-in-github-desktop.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Work with branches and pull requests
 ---
 
 ## About Git hooks in {% data variables.product.prodname_desktop %}
diff --git a/content/desktop/managing-commits/amending-a-commit-in-github-desktop.md b/content/desktop/managing-commits/amending-a-commit-in-github-desktop.md
@@ -9,6 +9,8 @@ versions:
 redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit-in-github-desktop
+category:
+  - Manage commits
 ---
 
 ## About amending a commit
diff --git a/content/desktop/managing-commits/checking-out-a-commit-in-github-desktop.md b/content/desktop/managing-commits/checking-out-a-commit-in-github-desktop.md
@@ -8,6 +8,8 @@ versions:
   ghes: '*'
 redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/checking-out-a-commit-in-github-desktop
+category:
+  - Manage commits
 ---
 
 ## About checking out a commit
diff --git a/content/desktop/managing-commits/cherry-picking-a-commit-in-github-desktop.md b/content/desktop/managing-commits/cherry-picking-a-commit-in-github-desktop.md
@@ -10,6 +10,8 @@ redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/cherry-picking-a-commit
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit-in-github-desktop
+category:
+  - Manage commits
 ---
 ## About Git cherry-pick
 
diff --git a/content/desktop/managing-commits/managing-tags-in-github-desktop.md b/content/desktop/managing-commits/managing-tags-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Manage commits
 ---
 ## About tags in {% data variables.product.prodname_desktop %}
 
diff --git a/content/desktop/managing-commits/options-for-managing-commits-in-github-desktop.md b/content/desktop/managing-commits/options-for-managing-commits-in-github-desktop.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Manage commits
 ---
 
 ## About commit history in {% data variables.product.prodname_desktop %}
diff --git a/content/desktop/managing-commits/reordering-commits-in-github-desktop.md b/content/desktop/managing-commits/reordering-commits-in-github-desktop.md
@@ -9,6 +9,8 @@ versions:
 redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reordering-commits
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reordering-commits-in-github-desktop
+category:
+  - Manage commits
 ---
 
 ## About reordering a commit
diff --git a/content/desktop/managing-commits/resetting-to-a-commit-in-github-desktop.md b/content/desktop/managing-commits/resetting-to-a-commit-in-github-desktop.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Manage commits
 ---
 
 ## About resetting to a commit
diff --git a/content/desktop/managing-commits/reverting-a-commit-in-github-desktop.md b/content/desktop/managing-commits/reverting-a-commit-in-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Manage commits
 ---
 When you revert to a previous commit, the revert is also a commit. The original commit also remains in the repository's history.
 
diff --git a/content/desktop/managing-commits/squashing-commits-in-github-desktop.md b/content/desktop/managing-commits/squashing-commits-in-github-desktop.md
@@ -9,6 +9,8 @@ versions:
 redirect_from:
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits
   - /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits-in-github-desktop
+category:
+  - Manage commits
 ---
 
 ## About squashing a commit
diff --git a/content/desktop/managing-commits/undoing-a-commit-in-github-desktop.md b/content/desktop/managing-commits/undoing-a-commit-in-github-desktop.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Manage commits
 ---
 
 ## About undoing a commit
diff --git a/content/desktop/overview/about-github-desktop.md b/content/desktop/overview/about-github-desktop.md
@@ -11,6 +11,8 @@ redirect_from:
   - /github/getting-started-with-github/github-desktop
   - /github/getting-started-with-github/using-github/github-desktop
   - /get-started/using-github/github-desktop
+category:
+  - Set up GitHub Desktop
 ---
 
 <a href="https://desktop.github.com?ref_product=desktop&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Download {% data variables.product.prodname_desktop %}</span> {% octicon "link-external" height:16 aria-label="link-external" %}</a>
diff --git a/content/desktop/overview/creating-your-first-repository-using-github-desktop.md b/content/desktop/overview/creating-your-first-repository-using-github-desktop.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Set up GitHub Desktop
 ---
 ## Introduction
 
diff --git a/content/desktop/overview/getting-started-with-github-desktop.md b/content/desktop/overview/getting-started-with-github-desktop.md
@@ -9,6 +9,8 @@ redirect_from:
   - /desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop
   - /desktop/guides/getting-started
 shortTitle: Get started
+category:
+  - Set up GitHub Desktop
 ---
 
 ## Introduction
diff --git a/content/desktop/overview/github-desktop-keyboard-shortcuts.md b/content/desktop/overview/github-desktop-keyboard-shortcuts.md
@@ -12,6 +12,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Configure and customize GitHub Desktop
 ---
 {% mac %}
 
diff --git a/content/desktop/overview/launching-github-desktop-from-the-command-line.md b/content/desktop/overview/launching-github-desktop-from-the-command-line.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghec: '*'
   ghes: '*'
+category:
+  - Configure and customize GitHub Desktop
 ---
 {% mac %}
 
diff --git a/content/desktop/overview/supported-operating-systems-for-github-desktop.md b/content/desktop/overview/supported-operating-systems-for-github-desktop.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Supported OS
+category:
+  - Set up GitHub Desktop
 ---
 ## About supported operating systems
 
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-the-remote-url-for-a-repository-in-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-the-remote-url-for-a-repository-in-github-desktop.md
@@ -13,6 +13,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Change the remote URL for a repository
+category:
+  - Add and clone repositories
 ---
 {% mac %}
 
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/configuring-notifications-in-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/configuring-notifications-in-github-desktop.md
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop.md
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop.md
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop.md
diff --git a/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop.md b/content/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop.md
