fix: better doc title generation (#7)

magicbell · Dec 19, 2024 · 1804bb1 · 1804bb1
1 parent e59c037
commit 1804bb1
Showing 1 changed file with 12 additions and 2 deletions.
diff --git a/scripts/docs.ts b/scripts/docs.ts
@@ -52,8 +52,18 @@ for (const file of docs) {
   md.reIndentHeadings(ast, 1);
   md.mapLinks(ast, rewriteHref);
 
-  const title = md.getTitle(ast);
-  md.insertFrontMatter(ast, { title });
+  let titleComponents = path.parse(file).name.split(".");
+  // Removing noisy namespaces
+  if (titleComponents.length > 1 && titleComponents[0] === "Components") {
+    titleComponents.shift();
+  }
+  if (titleComponents.length > 1 && titleComponents[0] === "Schemas") {
+    titleComponents.shift();
+  }
+  if (titleComponents.length > 1 && titleComponents[0] === "Operations") {
+    titleComponents.shift();
+  }
+  md.insertFrontMatter(ast, { title: titleComponents.join(".") });
   md.removeFirstHeading(ast);
 
   await md.write(ast, path.join(outdir, pascalToHyphenCase(file) + "x"));