Merge pull request #595 from sailpoint-oss/devrel-1673

Devrel 1673

plugins.js

@@ -1,3 +1,5 @@
+const {createApiPageMD} = require('./createApiPageMD');
+
 module.exports = [
   [
     'docusaurus2-dotenv',
@@ -1619,6 +1621,52 @@ module.exports = [
       },
     },
   ],
+  [
+    'docusaurus-plugin-openapi-docs',
+    {
+      id: 'isc-api',
+      docsPluginId: 'isc',
+      config: {
+        isc_versioned: {
+          specPath: 'static/api-specs/idn/sailpoint-api.v2024.yaml',
+          outputDir: 'docs/api/v2024',
+          sidebarOptions: {
+            groupPathsBy: 'tag',
+            categoryLinkSource: 'tag',
+          },
+          version: 'v2024',
+          label: 'v2024',
+          baseUrl: '/docs/api/v2024',
+          template: 'api.mustache',
+          markdownGenerators: {
+            createApiPageMD,
+          },
+          versions: {
+            // v2025: {
+            //   specPath: 'static/api-specs/idn/sailpoint-api.v2025.yaml',
+            //   outputDir: 'docs/api/v2025',
+            //   label: 'v2025',
+            //   baseUrl: '/docs/api/v2025',
+            // },
+            v3: {
+              specPath: 'static/api-specs/idn/sailpoint-api.v3.yaml',
+              outputDir: 'docs/api/v3',
+              downloadUrl: 'https://raw.githubusercontent.com/sailpoint-oss/api-specs/main/dereferenced/deref-sailpoint-api.v3.yaml',
+              label: 'v3',
+              baseUrl: '/docs/api/v3',
+            },
+            beta: {
+              specPath: 'static/api-specs/idn/sailpoint-api.beta.yaml',
+              outputDir: 'docs/api/beta',
+              downloadUrl: 'https://raw.githubusercontent.com/sailpoint-oss/api-specs/main/dereferenced/deref-sailpoint-api.beta.yaml',
+              label: 'Beta',
+              baseUrl: '/docs/api/beta',
+            },
+          },
+        },
+      },
+    },
+  ],
   [
     'docusaurus-plugin-openapi-docs',
     {
@@ -1660,7 +1708,7 @@ module.exports = [
     },
   ],
   [
-    "@gracefullight/docusaurus-plugin-microsoft-clarity",
-    { projectId: "naher5vlxx" },
+    '@gracefullight/docusaurus-plugin-microsoft-clarity',
+    {projectId: 'naher5vlxx'},
   ],
 ];