docs: Render OpenAPI content into md document, remove generated ymls …

…from git (DEV-3443) (#3254)

.gitignore

@@ -54,7 +54,6 @@ venv/
 
 # exclude generated openapi
 docs/03-endpoints/generated-openapi/*
-!docs/03-endpoints/generated-openapi/openapi-admin-api.yml
 
 # exclude test reports generated by xunit-viewer
 /index.html

docs/03-endpoints/api-admin/index.md

@@ -1,6 +1,5 @@
-We provide an [OpenAPI](https://spec.openapis.org/oas/latest.html) specification. 
+We provide an [OpenAPI](https://spec.openapis.org/oas/latest.html) specification for certain endpoints and are working on providing this for all endpoints.
 The latest version is located at [api.dasch.swiss/api/docs/docs.yaml](https://api.dasch.swiss/api/docs/docs.yaml).
-For an interactive documentation of all API endpoints, 
-please visit [api.dasch.swiss/api/docs/](https://api.dasch.swiss/api/docs/).
+For an interactive documentation of all API endpoints, please visit [api.dasch.swiss/api/docs/](https://api.dasch.swiss/api/docs/).
 
-[OAD](../generated-openapi/openapi-admin-api.yml)
+[OAD(./docs/03-endpoints/generated-openapi/openapi-admin-api.yml)]