openapi in readthedocs

docs/requirements.txt

@@ -7,3 +7,5 @@ sphinx-pdj-theme
 sphinx-copybutton
 sphinx-tabs
 sphinx-design
+sphinxcontrib-openapi
+sphinxcontrib-redoc

docs/source/api_reference/index.md

@@ -0,0 +1,7 @@
+# API Reference
+
+```{eval-rst}
+.. sphinxcontrib-redoc:: ../resources/llama-stack-spec.yaml
+   :page-title: API Reference
+   :expand-responses: all
+```

docs/source/conf.py

@@ -25,6 +25,8 @@ extensions = [
     "sphinx_copybutton",
     "sphinx_tabs.tabs",
     "sphinx_design",
+    # "sphinxcontrib.openapi",
+    "sphinxcontrib.redoc",
 ]
 myst_enable_extensions = ["colon_fence"]
 
@@ -82,3 +84,18 @@ html_theme_options = {
 html_static_path = ["../_static"]
 # html_logo = "../_static/llama-stack-logo.png"
 html_style = "../_static/css/my_theme.css"
+
+redoc = [
+    {
+        "name": "Llama Stack API",
+        "page": "api_reference/index",
+        "spec": "../resources/llama-stack-spec.yaml",
+        "opts": {
+            "suppress-warnings": True,
+            # "expand-responses": ["200", "201"],
+        },
+        "embed": True,
+    },
+]
+
+redoc_uri = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"

docs/source/index.md

@@ -97,4 +97,5 @@ concepts/index
 distributions/index
 contributing/index
 distribution_dev/index
+api_reference/index
 ```