add crdoc automation

Author: roothorp

.github/workflows/release-image.yml

@@ -257,7 +257,7 @@ jobs:
           cp -rf helm-charts "$RELEASE_DIR/"
           cp bundle.Dockerfile "$RELEASE_DIR/bundle.Dockerfile"
           cp licenses.csv "$RELEASE_DIR/"
-
+          cp docs/api-docs.md "$RELEASE_DIR/"
 
           git fetch origin
           git checkout -f -b "$BRANCH" origin/main

.github/workflows/validate-manifests.yml

@@ -16,4 +16,4 @@ jobs:
         with:
           enable-cache: 'true'
       - name: Run testing
-        run: devbox run -- 'make validate-manifests'
+        run: devbox run -- 'make validate-manifests validate-api-docs'

Makefile

@@ -292,7 +292,7 @@ ifneq ($(shell git ls-files -o -m --directory --exclude-standard --no-empty-dire
 	$(info Detected files that need to be committed:)
 	$(info $(shell git ls-files -o -m --directory --exclude-standard --no-empty-directory | sed -e "s/^/  /"))
 	$(info )
-	$(info Try running: make generate manifests)
+	$(info Try running: make generate manifests api-docs)
 	$(error Check: FAILED)
 else
 	$(info Check: PASS)
@@ -644,8 +644,15 @@ tools/githubjobs/githubjobs: tools/githubjobs/*.go
 tools/scandeprecation/scandeprecation: tools/scandeprecation/*.go
 	cd tools/scandeprecation && go test . && go build .
 
-
 .PHONY: slack-deprecations
 slack-deprecations: tools/scandeprecation/scandeprecation tools/githubjobs/githubjobs
 	@echo "Computing and sending deprecation report to Slack..."
-	GH_RUN_ID=$(GH_RUN_ID) ./tools/githubjobs/githubjobs | grep "javaMethod" | ./tools/scandeprecation/scandeprecations | ./scripts/slackit.sh $(SLACK_WEBHOOK)
+	GH_RUN_ID=$(GH_RUN_ID) ./tools/githubjobs/githubjobs | grep "javaMethod" | ./tools/scandeprecation/scandeprecations | ./scripts/slackit.sh $(SLACK_WEBHOOK)
+
+.PHONY: api-docs
+api-docs:
+	go tool crdoc --resources config/crd/bases --output docs/api-docs.md
+
+.PHONY: validate-api-docs
+validate-api-docs: api-docs
+	$(MAKE) check-missing-files