Adds redoc openapi plugin (#1312)

* adds redocusaurus plugin

* adds APIs dropdown

* adds unknown word to cspell

Author: ZPain8464

cspell.json

@@ -125,6 +125,7 @@
     "quic",
     "quickstart",
     "quickstarts",
+    "redocusaurus",
     "refreshdirectory",
     "rego",
     "Remmina",

docusaurus-plugins/src/webpackDebugFix.js

@@ -0,0 +1,20 @@
+// solution here: https://github.com/rohit-gohri/redocusaurus/issues/236#issuecomment-1449548972
+
+// solution here: https://github.com/rohit-gohri/redocusaurus/issues/236#issuecomment-1449548972
+
+module.exports = async function webpackDebugFix(context, opts) {
+  const webpack = require('webpack');
+
+  return {
+    name: 'webpack-fix-plugin',
+    configureWebpack(config, isServer, utils, content) {
+      return {
+        plugins: [
+          new webpack.DefinePlugin({
+            'process.env.DEBUG': 'process.env.DEBUG',
+          }),
+        ],
+      };
+    },
+  };
+};

docusaurus.config.js

@@ -61,6 +61,17 @@ const config = {
         },
       },
     ],
+    [
+      'redocusaurus',
+      {
+        specs: [
+          {
+            spec: 'https://console.pomerium.app/openapi.yaml',
+            route: '/docs/api/'
+          }
+        ]
+      }
+    ]
   ],
 
   themeConfig: {
@@ -96,6 +107,23 @@ const config = {
           label: 'Reference',
           to: '/docs/reference/',
         },
+        {
+          type: 'dropdown',
+          position: 'right',
+          label: 'APIs',
+          items: [
+            {
+              docId: 'docs/api',
+              label: 'Zero API',
+              to: '/docs/api/',
+            },
+            {
+              docId: 'docs/capabilities/enterprise-api',
+              label: 'Enterprise API',
+              to: 'docs/capabilities/enterprise-api',
+            }
+          ]
+        },
         {
           type: 'docSidebar',
           sidebarId: 'guides',
@@ -207,6 +235,7 @@ const config = {
         id: process.env.GTM,
       },
     ],
+    './docusaurus-plugins/src/webpackDebugFix.js',
   ],
 };
 

package.json

@@ -38,7 +38,8 @@
     "raw-loader": "^4.0.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "react-mailchimp-subscribe": "^2.1.3"
+    "react-mailchimp-subscribe": "^2.1.3",
+    "redocusaurus": "^2.0.2"
   },
   "browserslist": {
     "production": [