From 742c253fbc2b767429f3ff4bea9ec63a02ec0cb0 Mon Sep 17 00:00:00 2001
From: cubicroot <github@cubicroot.xyz>
Date: Sat, 5 Oct 2024 16:50:57 +0200
Subject: [PATCH] add some docu

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index dabfb60..a11da6d 100644
--- a/README.md
+++ b/README.md
@@ -64,4 +64,20 @@ jobs:
     uses: CubicrootXYZ/Workflows/.github/workflows/jinja.yaml@v1.0.0
     with:
       workdir: "tests/jinja/"
+```
+
+## OpenAPI
+
+### Render OpenAPI 2 specs with redoc
+
+Render an OpenAPI 2 spec with `redoc`. The spec file needs to be present in the given artifact. The rendered `index.html` will be added to the artifact `rendered-api-docu`.
+
+```yaml
+jobs:
+  render:
+    uses: CubicrootXYZ/Workflows/.github/workflows/openapi2_render.yaml
+    with:
+      spec_artifact_name: spec
+      spec_artifact_path: tests/openapi2/
+      spec_filename: petstore.yaml
 ```
\ No newline at end of file