Build docs of services category in a separate folder (#3453)

* Build docs of services category in a separate folder

* Remove spaces for autogenerated md filenames

Author: ethanshar

scripts/docs/buildDocsCommon.js

@@ -6,7 +6,9 @@ const childProcess = require('child_process');
 const fs = require('fs');
 
 const COMPONENTS_DOCS_DIR = './docs/components';
-const VALID_CATEGORIES = [
+const SERVICES_DOCS_DIR = './docs/services';
+
+const VALID_COMPONENTS_CATEGORIES = [
   'foundation',
   'basic',
   'assets',
@@ -21,7 +23,9 @@ const VALID_CATEGORIES = [
   'overlays',
   'charts',
   'incubator',
-  'infra'
+  'infra',
+  // non components categories
+  'services'
 ];
 
 function buildDocs(apiFolders, componentsPreProcess) {
@@ -64,7 +68,7 @@ function processComponents(components) {
     const isParentComponent = parentComponents.includes(componentName);
     const isIncubatorComponent = component.category === 'incubator';
 
-    if (!VALID_CATEGORIES.includes(component.category)) {
+    if (!VALID_COMPONENTS_CATEGORIES.includes(component.category)) {
       console.error(`${componentName} has invalid category "${component.category}"`);
     }
 
@@ -88,15 +92,21 @@ function processComponents(components) {
       content += `${buildOldDocs(component)}\n`;
     }
 
-    const componentParentDir =
-      componentParentName || isParentComponent ? `/${componentParentName || componentName}` : '';
-    const dirPath = `${COMPONENTS_DOCS_DIR}/${component.category}${componentParentDir}`;
+
+    let dirPath;
+    if (component.category === 'services') {
+      dirPath = `${SERVICES_DOCS_DIR}`;
+    } else {
+      const componentParentDir =
+        componentParentName || isParentComponent ? `/${componentParentName || componentName}` : '';
+      dirPath = `${COMPONENTS_DOCS_DIR}/${component.category}${componentParentDir}`;
+    }
 
     if (!fs.existsSync(dirPath)) {
       fs.mkdirSync(dirPath, {recursive: true});
     }
 
-    fs.writeFileSync(`${dirPath}/${component.name}.md`, content, {encoding: 'utf8'});
+    fs.writeFileSync(`${dirPath}/${component.name.replaceAll(' ', '_')}.md`, content, {encoding: 'utf8'});
   });
 }