Add link to Swagger docs to main menu (#284)

The HTTP API reference is not linked through the docs site so it's
not clear to a newcomer to Sigstore that one actually exists. This change
adds a link on the main menu out to the auto-generated Swagger site so
that it is easily discoverable.

Signed-off-by: Colleen Murphy <[email protected]>

Author: cmurphy

config/_default/menus/menus.en.toml

@@ -22,6 +22,12 @@
   identifier = "policy-controller"
   url = "https://github.com/sigstore/policy-controller/blob/main/docs/api-types/index.md"
 
+[[swagger]]
+  name = "OpenAPI Specification"
+  weight = 50
+  identifier = "swagger"
+  url = "https://www.sigstore.dev/swagger/"
+
 # [[main]]
 #   name = "Docs"
 #   url = "/docs/about/overview/"

layouts/partials/sidebar/auto-collapsible-menu.html

@@ -15,6 +15,15 @@
 
   {{ $Sections := site.Sections | append $ExternalSiteSection }}
 
+  {{ $SwaggerDocsPages := slice }}
+  {{- range site.Menus.swagger }}
+  {{ $NewPage := dict "TargetBlank" true "Title" .Name "Permalink" .ConfiguredURL }}
+    {{ $SwaggerDocsPages = $SwaggerDocsPages | append $NewPage }}
+  {{ end }}
+  {{ $SwaggerSection := dict "Title" "API Reference" "Pages" $SwaggerDocsPages }}
+
+  {{ $Sections = $Sections | append $SwaggerSection }}
+
 
   <!-- This changed from Doks default to reflect no "docs" section folder -->
     {{ range $Sections }}