feat: Update OFREP OpenAPI documentation (#347)

Signed-off-by: Jonathan Norris <[email protected]>

Author: jonathannorris

.markdown-link-check-config.json

@@ -1,5 +1,10 @@
 {
   "ignorePatterns": [
-    {"pattern": ".*split.io.*"}
+    {
+      "pattern": ".*split.io.*"
+    },
+    {
+      "pattern": ".*openfeature.dev/docs/reference/other-technologies/ofrep/openapi.*"
+    }
   ]
-}
+}

specification/README.md

@@ -19,7 +19,7 @@ sidebar_position: 0
 - [Tracking](./sections/06-tracking.md)
 - [Appendix A: Included Utilities](./appendix-a-included-utilities.md)
 - [Appendix B: Gherkin Suites](./appendix-b-gherkin-suites.md)
-- [Appendix C: OFREP](./appendix-c-ofrep.md)
+- [Appendix C: OFREP](./appendix-c/index.md)
 - [Appendix D: Observability](./appendix-d-observability.md)
 
 ## Conformance

specification/appendix-c/_category_.json

@@ -0,0 +1,5 @@
+{
+    "label": "Appendix C: OpenFeature Remote Evaluation Protocol",
+    "position": 5,
+    "collapsible": false
+}

specification/appendix-c-ofrep.md renamed to specification/appendix-c/index.md

@@ -2,7 +2,7 @@
 id: appendix-c
 title: "Appendix C: OpenFeature Remote Evaluation Protocol"
 description: A unified protocol for feature flagging
-sidebar_position: 5
+sidebar_position: 0
 ---
 
 # Appendix C: OpenFeature Remote Evaluation Protocol
@@ -17,3 +17,7 @@ There is a dedicated [OpenFeature working group](https://github.com/open-feature
 - Reference implementations of the protocol
 
 If you are interested in this initiative, you can join the [`#openfeature-remote-evaluation-protocol`](https://cloud-native.slack.com/archives/C066A48LK35) Slack channel on the [CNCF Slack](https://communityinviter.com/apps/cloud-native/cncf) workspace.
+
+## API Specification
+
+View the full [OFREP API Specification](https://openfeature.dev/docs/reference/other-technologies/ofrep/openapi) with interactive documentation.