Add discovery landing page for packages docs (#60283)

jc-clark · web-flow · commit c23b228855a7 · 2026-03-23T16:48:46.000Z
diff --git a/content/packages/index.md b/content/packages/index.md
@@ -4,30 +4,30 @@ shortTitle: '{% data variables.product.prodname_registry %}'
 intro: 'Learn to safely publish and consume packages, store your packages alongside your code, and share your packages privately with your team or publicly with the open source community. You can also automate your packages with {% data variables.product.prodname_actions %}.'
 introLinks:
   quickstart: /packages/quickstart
-  reference: /packages/learn-github-packages
-featuredLinks:
-  startHere:
-    - /packages/learn-github-packages
-    - /packages/managing-github-packages-using-github-actions-workflows
+  overview: /packages/learn-github-packages/introduction-to-github-packages
+includedCategories:
+  - Get started with packages
+  - Publish and manage packages
+  - Work with a package registry
+carousels:
+  recommended:
+    - /packages/quickstart
+    - /packages/learn-github-packages/introduction-to-github-packages
+    - /packages/learn-github-packages/about-permissions-for-github-packages
+    - /packages/learn-github-packages/publishing-a-package
     - /packages/learn-github-packages/installing-a-package
-  popular:
-    - /packages/working-with-a-github-packages-registry/working-with-the-npm-registry
-    - '{% ifversion ghes %}/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry{% endif %}'
-    - /packages/learn-github-packages
-    - /packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry
-  guideCards:
-    - '{% ifversion ghes %}/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry{% endif %}'
+    - /packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions
     - /packages/working-with-a-github-packages-registry/working-with-the-container-registry
-    - '{% ifversion packages-npm-v2 %}/packages/working-with-a-github-packages-registry/working-with-the-npm-registry{% endif %}'
-    - /packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry
+    - /packages/working-with-a-github-packages-registry/working-with-the-npm-registry
+    - /packages/learn-github-packages/configuring-a-packages-access-control-and-visibility
 changelog:
   label: packages
   prefix: 'Packages: '
 redirect_from:
   - /github/managing-packages-with-github-packages
   - /categories/managing-packages-with-github-package-registry
   - /github/managing-packages-with-github-package-registry
-layout: product-landing
+layout: discovery-landing
 versions:
   fpt: '*'
   ghes: '*'
@@ -38,4 +38,3 @@ children:
   - /working-with-a-github-packages-registry
   - /managing-github-packages-using-github-actions-workflows
 ---
-<!--This section is needed to determine the order of the left sidebar for now-->
diff --git a/content/packages/learn-github-packages/about-permissions-for-github-packages.md b/content/packages/learn-github-packages/about-permissions-for-github-packages.md
@@ -7,6 +7,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: About permissions
+category:
+  - Get started with packages
 ---
 
 The permissions for packages can be scoped either to a user or an organization or to a repository.
diff --git a/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md b/content/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Access control & visibility
+category:
+  - Publish and manage packages
 ---
 {% data reusables.package_registry.container-registry-ghes-beta %}
 
diff --git a/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md b/content/packages/learn-github-packages/connecting-a-repository-to-a-package.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Connect a repository
+category:
+  - Publish and manage packages
 ---
 
 When you publish a package that is scoped to a personal account or an organization, the package is not linked to a repository by default. If you connect a package to a repository, the package's landing page will show information and links from the repository, such as the README. You can also choose to have the package inherit its access permissions from the linked repository. For more information, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility).
diff --git a/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/content/packages/learn-github-packages/deleting-and-restoring-a-package.md
@@ -12,6 +12,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Delete & restore a package
+category:
+  - Publish and manage packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/learn-github-packages/installing-a-package.md b/content/packages/learn-github-packages/installing-a-package.md
@@ -11,6 +11,8 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+category:
+  - Get started with packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/learn-github-packages/introduction-to-github-packages.md b/content/packages/learn-github-packages/introduction-to-github-packages.md
@@ -15,6 +15,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Introduction
+category:
+  - Get started with packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/learn-github-packages/publishing-a-package.md b/content/packages/learn-github-packages/publishing-a-package.md
@@ -10,6 +10,8 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+category:
+  - Publish and manage packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/learn-github-packages/viewing-packages.md b/content/packages/learn-github-packages/viewing-packages.md
@@ -13,6 +13,8 @@ versions:
   fpt: '*'
   ghes: '*'
   ghec: '*'
+category:
+  - Get started with packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/managing-github-packages-using-github-actions-workflows/about-github-packages-and-github-actions.md b/content/packages/managing-github-packages-using-github-actions-workflows/about-github-packages-and-github-actions.md
@@ -8,6 +8,8 @@ versions:
 shortTitle: Packages & Actions
 redirect_from:
   - /actions/publishing-packages/about-packaging-with-github-actions
+category:
+  - Get started with packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/managing-github-packages-using-github-actions-workflows/example-workflows-for-publishing-a-package.md b/content/packages/managing-github-packages-using-github-actions-workflows/example-workflows-for-publishing-a-package.md
@@ -6,6 +6,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Example workflows
+category:
+  - Publish and manage packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md b/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md
@@ -14,6 +14,8 @@ versions:
   ghec: '*'
 shortTitle: Publish & install with Actions
 layout: inline
+category:
+  - Publish and manage packages
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/quickstart.md b/content/packages/quickstart.md
@@ -7,6 +7,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Quickstart
+category:
+  - Get started with packages
 ---
 
 {% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md b/content/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Migration to Container registry
+category:
+  - Work with a package registry
 ---
 
 {% data reusables.package_registry.container-registry-ghes-beta %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry.md
@@ -13,6 +13,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Apache Maven registry
+category:
+  - Work with a package registry
 ---
 
 {% ifversion ghec %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-container-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-container-registry.md
@@ -17,6 +17,8 @@ versions:
   ghec: '*'
   ghes: '*'
 shortTitle: Container registry
+category:
+  - Work with a package registry
 ---
 
 {% data reusables.package_registry.container-registry-ghes-beta %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-docker-registry.md
@@ -14,6 +14,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Docker registry
+category:
+  - Work with a package registry
 ---
 
 <!-- Main versioning block. Short page for dotcom -->
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry.md
@@ -13,6 +13,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: Gradle registry
+category:
+  - Work with a package registry
 ---
 
 {% ifversion ghec %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-npm-registry.md
@@ -13,6 +13,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: npm registry
+category:
+  - Work with a package registry
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.md
@@ -14,6 +14,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: NuGet registry
+category:
+  - Work with a package registry
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md b/content/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry.md
@@ -13,6 +13,8 @@ versions:
   ghes: '*'
   ghec: '*'
 shortTitle: RubyGems registry
+category:
+  - Work with a package registry
 ---
 
 {% data reusables.package_registry.packages-ghes-release-stage %}
