Add discovery landing page for content/pages (#60012)

jc-clark · web-flow · commit d3114e428f56 · 2026-03-04T20:25:54.000Z
diff --git a/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md b/content/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Custom domains in GitHub Pages
+category:
+  - Learn about GitHub Pages
 ---
 
 ## Supported custom domains
diff --git a/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md b/content/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site.md
@@ -18,6 +18,8 @@ versions:
 topics:
   - Pages
 shortTitle: Manage a custom domain
+category:
+  - Set up a GitHub Pages site
 ---
 
 People with admin permissions for a repository can configure a custom domain for a {% data variables.product.prodname_pages %} site.
diff --git a/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md b/content/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Troubleshoot a custom domain
+category:
+  - Troubleshoot a GitHub Pages site error
 ---
 
 ## CNAME errors
diff --git a/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md b/content/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages.md
@@ -8,6 +8,8 @@ versions:
 topics:
   - Pages
 shortTitle: Verify a custom domain
+category:
+  - Managing a GitHub Pages site
 ---
 
 ## About domain verification for GitHub Pages
diff --git a/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md b/content/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site.md
@@ -7,6 +7,8 @@ permissions: 'People with admin access to a repository can change the visibility
 redirect_from:
   - /github/working-with-github-pages/changing-the-visibility-of-your-github-pages-site
 shortTitle: Change visibility of site
+category:
+  - Managing a GitHub Pages site
 ---
 
 ## About access control for {% data variables.product.prodname_pages %} sites
diff --git a/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md b/content/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Configure publishing source
+category:
+  - Set up a GitHub Pages site
 ---
 
 ## About publishing sources
diff --git a/content/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md b/content/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site.md
@@ -13,6 +13,8 @@ versions:
 topics:
   - Pages
 shortTitle: Create custom 404 page
+category:
+  - Set up a GitHub Pages site
 ---
 
 {% data reusables.pages.navigate-site-repo %}
diff --git a/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md b/content/pages/getting-started-with-github-pages/creating-a-github-pages-site.md
@@ -16,6 +16,8 @@ versions:
 topics:
   - Pages
 shortTitle: Create a GitHub Pages site
+category:
+  - Set up a GitHub Pages site
 ---
 
 
diff --git a/content/pages/getting-started-with-github-pages/deleting-a-github-pages-site.md b/content/pages/getting-started-with-github-pages/deleting-a-github-pages-site.md
@@ -10,6 +10,8 @@ versions:
 topics:
   - Pages
 shortTitle: Delete a GitHub Pages site
+category:
+  - Managing a GitHub Pages site
 ---
 
 ## Deleting your site
diff --git a/content/pages/getting-started-with-github-pages/github-pages-limits.md b/content/pages/getting-started-with-github-pages/github-pages-limits.md
@@ -8,6 +8,8 @@ versions:
   ghec: '*'
 topics:
   - Pages
+category:
+  - Set up a GitHub Pages site
 ---
 
 ## Usage limits
diff --git a/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md b/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md
@@ -11,6 +11,8 @@ versions:
 topics:
   - Pages
 shortTitle: Secure site with HTTPS
+category:
+  - Set up a GitHub Pages site
 ---
 
 People with admin permissions for a repository can enforce HTTPS for a {% data variables.product.prodname_pages %} site.
diff --git a/content/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites.md b/content/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites.md
@@ -9,6 +9,8 @@ versions:
 topics:
   - Pages
 shortTitle: Troubleshoot 404 errors
+category:
+  - Troubleshoot a GitHub Pages site error
 ---
 
 ## Troubleshooting 404 errors
diff --git a/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md b/content/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site.md
@@ -17,6 +17,8 @@ versions:
 topics:
   - Pages
 shortTitle: Unpublish Pages site
+category:
+  - Managing a GitHub Pages site
 ---
 
 When you unpublish your site, your current deployment is removed and the site will no longer be available. Any existing repository settings or content will not be affected.
diff --git a/content/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages.md b/content/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages.md
@@ -9,6 +9,8 @@ versions:
 topics:
   - Pages
 shortTitle: Use custom workflows
+category:
+  - Set up a GitHub Pages site
 ---
 
 ## About custom workflows
diff --git a/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md b/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md
@@ -12,6 +12,8 @@ versions:
 topics:
   - Pages
 shortTitle: Use submodules with Pages
+category:
+  - Set up a GitHub Pages site
 ---
 
 If the repository for your {% data variables.product.prodname_pages %} site contains submodules, their contents will automatically be pulled in when your site is built.
diff --git a/content/pages/getting-started-with-github-pages/what-is-github-pages.md b/content/pages/getting-started-with-github-pages/what-is-github-pages.md
@@ -19,6 +19,8 @@ versions:
   ghec: '*'
 topics:
   - Pages
+category:
+  - Learn about GitHub Pages
 ---
 
 ## About {% data variables.product.prodname_pages %}
diff --git a/content/pages/index.md b/content/pages/index.md
@@ -1,33 +1,18 @@
 ---
 title: "{% data variables.product.prodname_pages %} documentation"
 shortTitle: "{% data variables.product.prodname_pages %}"
-intro: 'Learn how to create a website directly from a repository on {% data variables.product.prodname_dotcom %}. Explore website building tools like Jekyll and troubleshoot issues with your {% data variables.product.prodname_pages %} site.'
+intro: '{% data variables.product.prodname_pages %} turns any {% data variables.product.github %} repository into a live website—no separate hosting required.'
 introLinks:
   quickstart: /pages/quickstart
   overview: /pages/getting-started-with-github-pages/what-is-github-pages
-featuredLinks:
-  startHere:
-    - /pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
-    - /pages/getting-started-with-github-pages/creating-a-github-pages-site
-    - '{% ifversion fpt or ghec %}/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site{% endif %}'
-    - '{% ifversion ghes %}/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll{% endif %}'
-    - '{% ifversion ghec %}/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site{% endif %}'
-    - '{% ifversion ghes %}/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll{% endif %}'
-  popular:
-    - '{% ifversion fpt or ghec %}/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages{% endif %}'
-    - /pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll
-    - '{% ifversion fpt or ghec %}/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages{% endif %}'
-    - '{% ifversion fpt or ghec %}/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https{% endif %}'
-    - '{% ifversion ghes %}/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site{% endif %}'
-    - '{% ifversion ghes %}/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll{% endif %}'
-    - '{% ifversion ghes %}/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll{% endif %}'
-  guideCards:
-    - /pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site
-    - /pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll
-    - /pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites
 changelog:
   label: pages
-layout: product-landing
+layout: discovery-landing
+includedCategories:
+  - Learn about GitHub Pages
+  - Set up a GitHub Pages site
+  - Managing a GitHub Pages site
+  - Troubleshoot a GitHub Pages site error
 redirect_from:
   - /categories/20/articles
   - /categories/95/articles
diff --git a/content/pages/quickstart.md b/content/pages/quickstart.md
@@ -11,6 +11,8 @@ topics:
   - Pages
 shortTitle: Quickstart
 product: '{% data reusables.gated-features.pages %}'
+category:
+  - Set up a GitHub Pages site
 ---
 
 ## Introduction
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll.md
@@ -26,6 +26,8 @@ versions:
 topics:
   - Pages
 shortTitle: GitHub Pages & Jekyll
+category:
+  - Learn about GitHub Pages
 ---
 
 {% data reusables.pages.actions-is-preferred %}
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Jekyll build errors for Pages
+category:
+  - Set up a GitHub Pages site
 ---
 
 {% data reusables.pages.actions-is-preferred %}
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md
@@ -15,6 +15,8 @@ versions:
 topics:
   - Pages
 shortTitle: Add theme to Pages site
+category:
+  - Set up a GitHub Pages site
 ---
 
 {% data reusables.pages.actions-is-preferred %}
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll.md
@@ -12,6 +12,8 @@ versions:
 topics:
   - Pages
 shortTitle: Add content to Pages site
+category:
+  - Managing a GitHub Pages site
 ---
 
 {% data reusables.pages.actions-is-preferred %}
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll.md
@@ -13,6 +13,8 @@ versions:
 topics:
   - Pages
 shortTitle: Create site with Jekyll
+category:
+  - Set up a GitHub Pages site
 ---
 
 
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Set Markdown processor
+category:
+  - Managing a GitHub Pages site
 ---
 
 {% data reusables.pages.actions-is-preferred %}
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll.md
@@ -14,6 +14,8 @@ versions:
 topics:
   - Pages
 shortTitle: Test site locally with Jekyll
+category:
+  - Set up a GitHub Pages site
 ---
 
 Anyone with read permissions for a repository can test a {% data variables.product.prodname_pages %} site locally.
diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites.md
@@ -33,6 +33,8 @@ versions:
 topics:
   - Pages
 shortTitle: Troubleshoot Jekyll errors
+category:
+  - Troubleshoot a GitHub Pages site error
 ---
 
 ## Troubleshooting build errors
