switched to using elastic crd-ref-docs which generates a proper md

Makefile

@@ -37,10 +37,14 @@ manifests: $(VGOPATH) $(CONTROLLER_GEN)
 	@find "$(REPO_ROOT)/config/crd/bases" -name "*.yaml" -exec cp '{}' "$(REPO_ROOT)/charts/druid/charts/crds/templates/" \;
 	@controller-gen rbac:roleName=manager-role paths="./internal/controller/..."
 
+.PHONY: generate-api-docs
+generate-api-docs: $(CRD_REF_DOCS)
+	@crd-ref-docs --source-path "$(REPO_ROOT)/api" --config "$(HACK_DIR)/api-reference/config.yaml" --output-path "$(REPO_ROOT)/docs/api-reference/etcd-druid-api.md" --renderer markdown
+
 # Generate code
 .PHONY: generate
-generate: manifests $(CONTROLLER_GEN) $(GOIMPORTS) $(MOCKGEN)
-	@go generate "$(REPO_ROOT)/internal/..."
+generate: manifests generate-api-docs $(CONTROLLER_GEN) $(GOIMPORTS) $(MOCKGEN)
+	@go generate "$(REPO_ROOT)/..."
 	@"$(HACK_DIR)/update-codegen.sh"
 
 # Rules for verification, formatting, linting and cleaning