Fix openapi deatils (#2594)

* fix spectral vscode extension

so that it takes the special rules into account. See
stoplightio/vscode-spectral#162 (comment)

* include cloudfront parameters in assets urls

also: replace gated example with non-gated one

.vscode/monorepo.code-workspace

@@ -9,10 +9,6 @@
       "name": "chart",
       "path": "../chart"
     },
-    {
-      "name": "docs",
-      "path": "../docs"
-    },
     {
       "name": "e2e",
       "path": "../e2e"
@@ -73,7 +69,6 @@
   "settings": {
     "files.exclude": {
       "chart": true,
-      "docs": true,
       "e2e": true,
       "jobs": true,
       "libs": true,