docs: unify documentation

Strictly enforce diataxis
Use resource driven approach
Can extend later to add 'developer' link index page

docs/site/api.md

@@ -0,0 +1,7 @@
+---
+template: options.html
+hide:
+  - navigation
+  - toc
+---
+<redoc src="/openapi.json" />