feat: add redoc to documentation

Signed-off-by: Lukas Reining <[email protected]>

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "external-content/community"]
 	path = external-content/community
 	url = https://github.com/open-feature/community
+[submodule "external-content/protocol"]
+	path = external-content/protocol
+	url = https://github.com/open-feature/protocol

docs/reference/technologies/ofrep/_category_.json

@@ -0,0 +1,4 @@
+{
+  "collapsible": true,
+  "collapsed": false
+}

docs/reference/technologies/ofrep/index.mdx

@@ -0,0 +1,11 @@
+---
+sidebar_position: 3
+id: ofrep
+title: OpenFeature Remote Evaluation Protocol
+---
+
+# Server
+
+import ApiDocMdx from '@theme/ApiDocMdx';
+
+<ApiDocMdx />

docusaurus.config.ts

@@ -1,6 +1,7 @@
 import type { Options as PresetClassicOptions } from '@docusaurus/preset-classic';
 import type { UserThemeConfig as ThemeCommonConfig } from '@docusaurus/theme-common';
 import type { UserThemeConfig as AlgoliaThemeConfig } from '@docusaurus/theme-search-algolia';
+import type * as Redocusaurus from 'redocusaurus';
 import type { Config } from '@docusaurus/types';
 import autoprefixer from 'autoprefixer';
 import { themes } from 'prism-react-renderer';
@@ -172,7 +173,7 @@ const themeConfig: ThemeCommonConfig & AlgoliaThemeConfig = {
   },
   prism: {
     theme: themes.oceanicNext,
-    additionalLanguages: ['java', 'csharp', 'powershell', 'php', 'kotlin', 'ruby'],
+    additionalLanguages: ['java', 'csharp', 'powershell', 'php', 'kotlin', 'ruby', 'scala'],
     magicComments: [
       {
         className: 'theme-code-block-highlighted-line',
@@ -284,7 +285,23 @@ const config: Config = {
       },
     },
   ],
-  presets: [['classic', presetClassicOptions]],
+  presets: [
+    ['classic', presetClassicOptions],
+    [
+      'redocusaurus',
+      {
+        specs: [
+          {
+            id: 'ofrep',
+            spec: './external-content/protocol/service/openapi.yaml',
+          },
+        ],
+        theme: {
+          primaryColor: '#5D5DFF',
+        },
+      },
+    ] satisfies Redocusaurus.PresetEntry,
+  ],
   plugins: [
     async function tailwind() {
       return {

package.json

@@ -57,6 +57,7 @@
     "react-instantsearch": "^7.15.3",
     "react-lite-youtube-embed": "^2.4.0",
     "react-transition-group": "^4.4.5",
+    "redocusaurus": "^2.2.1",
     "rehype-github-alerts": "^3.0.0",
     "remark-gfm": "^4.0.1",
     "remarkable": "2.0.1",
@@ -84,7 +85,7 @@
     "fs-extra": "11.3.0",
     "markdownlint-cli2": "^0.17.2",
     "markdownlint-rule-max-one-sentence-per-line": "^0.0.2",
-    "prettier": "3.5.1",
+    "prettier": "3.5.2",
     "typescript": "5.7.3",
     "wireit": "^0.14.11"
   },

redocly.yaml

@@ -0,0 +1,13 @@
+extends:
+  - recommended
+
+theme:
+  # See https://redocly.com/docs/redoc/config/
+  openapi:
+    disableSearch: true
+    hideDownloadButton: true
+    # See https://redocly.com/docs/api-reference-docs/configuration/theming/
+    theme:
+      colors:
+        primary:
+          main: '#32329f'