add some docu

README.md

@@ -50,4 +50,20 @@ jobs:
       workdir: "tests/golang_test/"
       services: '{"database": {"image": "mysql:8.0", "ports": ["3306:3306"]}}'
       env: '{"TESTENV": "value"}'
+```
+
+## 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
 ```