Fix and unskip category pages test (#63665)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 3725887d-99f1-4760-b935-f3fe2443bbd6
docs-bot · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026
commit e8b0a578ec45b3aecddc9f6f899d3420969a0761
diff --git a/content/admin/managing-iam/index.md b/content/admin/managing-iam/index.md
@@ -5,6 +5,7 @@ redirect_from:
   - /enterprise/admin/authentication
   - /admin/authentication
   - /admin/identity-and-access-management
+allowTitleToDifferFromFilename: true
 versions:
   ghec: '*'
   ghes: '*'

diff --git a/content/codespaces/about-codespaces/index.md b/content/codespaces/about-codespaces/index.md
@@ -2,6 +2,7 @@
 title: 'Getting started with {% data variables.product.prodname_github_codespaces %}'
 shortTitle: Getting started
 intro: 'Learn how to get started with {% data variables.product.prodname_github_codespaces %}, then find out more about how a codespace works.'
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
   ghec: '*'

diff --git a/content/get-started/learning-to-code/index.md b/content/get-started/learning-to-code/index.md
@@ -2,6 +2,7 @@
 title: Learn to code with GitHub Copilot
 shortTitle: Learn to code
 intro: "Learn how {% data variables.product.github %} and {% data variables.product.prodname_copilot_short %} can help you build programming skills, write better code, and ship secure projects."
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
 layout: journey-landing

diff --git a/content/migrations/ado/index.md b/content/migrations/ado/index.md
@@ -2,6 +2,7 @@
 title: Migrating from Azure DevOps
 shortTitle: Migrate from Azure DevOps
 intro: Plan and execute a migration from Azure DevOps to {% data variables.product.prodname_ghe_cloud %}. This six-part guide explains how to configure access, migrate, and the follow-up tasks needed to get your repositories ready for work.
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
   ghec: '*'

diff --git a/content/migrations/elm/index.md b/content/migrations/elm/index.md
@@ -2,6 +2,7 @@
 title: Live migrations from GitHub Enterprise Server to GHE.com
 shortTitle: Live migrations (GHES to GHE.com)
 intro: 'Use the Enterprise Live Migrations tool to migrate repositories with minimal downtime for developers.'
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
   ghec: '*'

diff --git a/content/migrations/troubleshooting/index.md b/content/migrations/troubleshooting/index.md
@@ -2,6 +2,7 @@
 title: Troubleshooting migrations
 shortTitle: Troubleshoot migrations
 intro: 'Troubleshoot common issues when migrating repositories with {% data variables.product.prodname_importer_proper_name %}.'
+allowTitleToDifferFromFilename: true
 versions:
   ghec: '*'
 children:

diff --git a/content/nonprofit/contributing-to-open-source-for-good/index.md b/content/nonprofit/contributing-to-open-source-for-good/index.md
@@ -1,6 +1,7 @@
 ---
 title: Open Source Projects for Good
 intro: Nonprofit organizations can partner with open source collaborators to build solutions together.
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
 children:

diff --git a/content/nonprofit/nonprofit-enterprise-plan/index.md b/content/nonprofit/nonprofit-enterprise-plan/index.md
@@ -1,6 +1,7 @@
 ---
 title: GitHub Enterprise Cloud for nonprofits
 intro: Learn how to apply for a discounted GitHub Enterprise Cloud plan for nonprofits.
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
 shortTitle: Discounted GitHub Enterprise Cloud plan for nonprofits

diff --git a/content/nonprofit/nonprofit-teams-plan/index.md b/content/nonprofit/nonprofit-teams-plan/index.md
@@ -1,6 +1,7 @@
 ---
 title: GitHub Team plan for nonprofits
 intro: Learn how to apply for a free GitHub Team plan for nonprofits.
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
 shortTitle: Free GitHub Team plan for nonprofits

diff --git a/content/nonprofit/troubleshooting/index.md b/content/nonprofit/troubleshooting/index.md
@@ -1,6 +1,7 @@
 ---
 title: Frequently asked questions
 intro: Troubleshooting for GitHub for Nonprofits applications
+allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
 children:

diff --git a/src/content-linter/tests/category-pages.ts b/src/content-linter/tests/category-pages.ts
@@ -10,7 +10,6 @@ import { beforeAll, describe, expect, test } from 'vitest'
 
 import matter from '@/frame/lib/read-frontmatter'
 import { renderContent } from '@/content-render/index'
-import getApplicableVersions from '@/versions/lib/get-applicable-versions'
 import contextualize from '@/frame/middleware/context/context'
 import shortVersions from '@/versions/middleware/short-versions'
 import { ROOT } from '@/frame/lib/constants'
@@ -26,7 +25,7 @@ function getFrontmatterData(markdown: string): MarkdownFrontmatter {
   return parsed.data as MarkdownFrontmatter
 }
 
-describe.skip('category pages', () => {
+describe('category pages', () => {
   const walkOptions = {
     globs: ['*/index.md', 'enterprise/*/index.md'],
     ignore: [
@@ -76,14 +75,10 @@ describe.skip('category pages', () => {
       (indexRelPath, indexAbsPath, indexLink) => {
         let publishedArticlePaths: string[] = []
         let availableArticlePaths: string[] = []
-        let categoryVersions: string[] = []
 
         let allowTitleToDifferFromFilename: boolean | undefined = false
         let indexTitle: string = ''
         let indexShortTitle: string = ''
-        const articleVersions: {
-          [articlePath: string]: string[]
-        } = {}
 
         beforeAll(async () => {
           const categoryDir = path.dirname(indexAbsPath)
@@ -92,7 +87,6 @@ describe.skip('category pages', () => {
           const parsed = matter(indexContents)
           if (!parsed.data) throw new Error('No frontmatter')
           const categoryData = parsed.data as MarkdownFrontmatter
-          categoryVersions = getApplicableVersions(categoryData.versions, indexAbsPath)
           allowTitleToDifferFromFilename = categoryData.allowTitleToDifferFromFilename
           const articleLinks = categoryData.children.filter((child) => {
             const mdPath = getPath(productDir, indexLink, child)
@@ -112,17 +106,14 @@ describe.skip('category pages', () => {
           await contextualize(req as ExtendedRequest, res as Response, next)
           await shortVersions(req as ExtendedRequest, res as Response, next)
 
-          const productIndexContents = await fs.promises.readFile(productIndex, 'utf8')
-          const productIndexData = getFrontmatterData(productIndexContents)
+          indexTitle = categoryData.title.includes('{')
+            ? await renderContent(categoryData.title, req.context, { textOnly: true })
+            : categoryData.title
 
-          indexTitle = productIndexData.title.includes('{')
-            ? await renderContent(productIndexData.title, req.context, { textOnly: true })
-            : productIndexData.title
-
-          if (productIndexData.shortTitle) {
-            indexShortTitle = productIndexData.shortTitle.includes('{')
-              ? await renderContent(productIndexData.shortTitle, req.context, { textOnly: true })
-              : productIndexData.shortTitle
+          if (categoryData.shortTitle) {
+            indexShortTitle = categoryData.shortTitle.includes('{')
+              ? await renderContent(categoryData.shortTitle, req.context, { textOnly: true })
+              : categoryData.shortTitle
           } else {
             indexShortTitle = ''
           }
@@ -145,7 +136,7 @@ describe.skip('category pages', () => {
 
           const childEntries = await fs.promises.readdir(categoryDir, { withFileTypes: true })
           const childFileEntries = childEntries.filter(
-            (ent) => ent.isFile() && ent.name !== 'index.md',
+            (ent) => ent.isFile() && ent.name.endsWith('.md') && ent.name !== 'index.md',
           )
           const childFilePaths = childFileEntries.map((ent) => path.join(categoryDir, ent.name))
 
@@ -163,18 +154,6 @@ describe.skip('category pages', () => {
               }),
             )
           ).filter(Boolean) as string[]
-
-          await Promise.all(
-            childFilePaths.map(async (articlePath) => {
-              const articleContents = await fs.promises.readFile(articlePath, 'utf8')
-              const versionData = getFrontmatterData(articleContents)
-
-              articleVersions[articlePath] = getApplicableVersions(
-                versionData.versions,
-                articlePath,
-              ) as string[]
-            }),
-          )
         })
 
         test('contains all expected articles', () => {
@@ -189,14 +168,6 @@ describe.skip('category pages', () => {
           expect(unexpectedArticles.length, errorMessage).toBe(0)
         })
 
-        test('contains only articles and subcategories with versions that are also available in the parent category', () => {
-          for (const [articleName, versions] of Object.entries(articleVersions)) {
-            const unexpectedVersions = difference(versions, categoryVersions)
-            const errorMessage = `${articleName} has versions that are not available in parent category`
-            expect(unexpectedVersions.length, errorMessage).toBe(0)
-          }
-        })
-
         test('slugified title matches parent directory name', () => {
           if (allowTitleToDifferFromFilename) return