docs(platform): publish versioned interactive API reference (Swagger UI)

Move the generated api.html into a leaf bundle under docs/platform/api/reference/
so the aggregator copies it into each versioned docs tree. A tiny index.md stub
routes it through a raw-passthrough layout (type: swagger) that serves the
self-contained Swagger UI verbatim at /docs/platform/<version>/api/reference/.
Link it from the API README's OpenAPI paragraph (not the sidebar).

Requires the companion layouts/swagger/single.html in the website repo.

Signed-off-by: Tamal Saha <tamal@appscode.com>

Author: tamalsaha

docs/platform/api/README.md

@@ -29,9 +29,9 @@ marketplace webhook service is a separate listener rooted at `/marketplace/api/v
 
 A machine-readable [OpenAPI 3.0.3 specification](../api/openapi.yaml) of this API is
 also available (`openapi.yaml`) — load it into any OpenAPI tool (Swagger UI, Redoc,
-`openapi-generator`) to explore the API or generate a client. A self-contained
-Swagger UI viewer (`api.html`, with the spec inlined) is available at the repository
-root.
+`openapi-generator`) to explore the API or generate a client. A self-contained,
+interactive [Swagger UI viewer](../api/reference/) (with the spec inlined) is also
+published for this release — open it to browse and try every endpoint in the browser.
 
 ## Overview
 

api.html docs/platform/api/reference/api.htmlapi.html renamed to docs/platform/api/reference/api.html

@@ -0,0 +1,5 @@
+---
+title: Interactive API Reference
+type: swagger
+layout: single
+---