misc: remove API doc make target, CI check

Creating this file is now handled by the same script that generates the
OpenAPI doc, so being able to build it independently and needing to
check it for drift don't make a ton of sense.

Signed-off-by: Hank Donnay <[email protected]>

Author: hdonnay

.github/workflows/main.yml

@@ -38,11 +38,6 @@ jobs:
             printf '::error file=%s,title=Bad Filename::Disallowed character in file name\n' "$file"
           done
           exit $(git ls-files -- ':/:*[<>:"|?*]*' | wc -l)
-      - name: Check API Reference
-        if: ${{ !cancelled() && steps.checkout.conclusion == 'success' }}
-        run: |
-          npx widdershins --search false --language_tabs 'python:Python' 'go:Golang' 'javascript:Javascript' --summary ./openapi.yaml -o ./Documentation/reference/api.md
-          git diff --exit-code
       - name: Check Container Versions
         if: ${{ !cancelled() && steps.checkout.conclusion == 'success' }}
         run: |

Makefile

@@ -29,16 +29,6 @@ rm_pat =
 all:
 	$(go) build ./cmd/...
 
-# Use https://github.com/Mermade/widdershins to convert openapi.yaml to
-# markdown. You'll need to have npx to run this.
-Documentation/reference/api.md: openapi.yaml
-	npx widdershins\
-		--search false \
-		--language_tabs 'python:Python' 'go:Golang' 'javascript:Javascript' \
-		--summary $< \
-		-o $@
-# Intended to be checked-in, so not cleaned.
-
 contrib/openshift/grafana/dashboards/dashboard-clair.configmap.yaml: \
 	local-dev/grafana/provisioning/dashboards/clair.json \
 	contrib/openshift/grafana/dashboard-clair.configmap.yaml.tpl