Script to update filepaths to match short titles (#56749)

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: Copilot <[email protected]>

Author: 3 people

package.json

@@ -100,6 +100,7 @@
     "unallowed-contributions": "tsx src/workflows/unallowed-contributions.ts",
     "update-data-and-image-paths": "tsx src/early-access/scripts/update-data-and-image-paths.ts",
     "update-enterprise-dates": "tsx src/ghes-releases/scripts/update-enterprise-dates.ts",
+    "update-filepaths": "tsx src/content-render/scripts/update-filepaths.ts",
     "update-internal-links": "tsx src/links/scripts/update-internal-links.ts",
     "validate-asset-images": "tsx src/assets/scripts/validate-asset-images.ts",
     "validate-github-github-docs-urls": "tsx src/links/scripts/validate-github-github-docs-urls/index.ts",

src/content-render/scripts/move-content.js

@@ -172,6 +172,9 @@ async function main(opts, nameTuple) {
   // the file is a folder or not. It just needs to know the old and new hrefs.
   changeFeaturedLinks(oldHref, newHref)
 
+  // Update any links in ChildGroups on the homepage.
+  changeHomepageLinks(oldHref, newHref, verbose)
+
   if (!undo) {
     if (verbose) {
       console.log(
@@ -581,14 +584,31 @@ function changeLearningTracks(filePath, oldHref, newHref) {
   fs.writeFileSync(filePath, newContent, 'utf-8')
 }
 
+function changeHomepageLinks(oldHref, newHref, verbose) {
+  // Can't deserialize and serialize the Yaml because it would lose
+  // formatting and comments. So regex replace it.
+  // Homepage childGroup links do not have a leading '/', so we need to remove that.
+  const homepageOldHref = oldHref.replace('/', '')
+  const homepageNewHref = newHref.replace('/', '')
+  const escapedHomepageOldHref = escapeStringRegexp(homepageOldHref)
+  const regex = new RegExp(`- ${escapedHomepageOldHref}$`, 'gm')
+  const homepage = path.join(CONTENT_ROOT, 'index.md')
+  const oldContent = fs.readFileSync(homepage, 'utf-8')
+  const newContent = oldContent.replace(regex, `- ${homepageNewHref}`)
+  if (oldContent !== newContent) {
+    fs.writeFileSync(homepage, newContent, 'utf-8')
+    if (verbose) console.log(`Updated homepage links`)
+  }
+}
+
 function changeFeaturedLinks(oldHref, newHref) {
   const allFiles = walk(CONTENT_ROOT, {
     globs: ['**/*.md'],
     includeBasePath: true,
     directories: false,
   }).filter((file) => !file.includes('README.md'))
 
-  const regex = new RegExp(`(^|%})${escapeStringRegexp(oldHref)}($|{%)`)
+  const regex = new RegExp(`(^|%} )${escapeStringRegexp(oldHref)}($| {%)`)
 
   for (const file of allFiles) {
     let changed = false