chore(docs): automatic generate pipeline docs (#1699)

* chore(docs): automatic generate pipeline docs

This commit adds a make target to generate documentation for pipelines.
It also makes it run during the verify github workflow, alongside the
generation of documentation of melange itself.

Signed-off-by: Massimiliano Giovagnoli <massimiliano.giovagnoli@chainguard.dev>

* docs(pipelines/cargo): update inputs

Signed-off-by: Massimiliano Giovagnoli <massimiliano.giovagnoli@chainguard.dev>

---------

Signed-off-by: Massimiliano Giovagnoli <massimiliano.giovagnoli@chainguard.dev>

.github/workflows/verify.yaml

@@ -34,6 +34,7 @@ jobs:
 
       - run: |
           make docs-repo
+          make docs-pipeline
           git diff --exit-code
 
       - run: |

Makefile

@@ -204,6 +204,14 @@ docs:
 docs-repo:
 	go run docs/main.go --baseurl /docs/md/ --suffix .md --out docs/md
 
+##################
+# docs-pipeline - This creates documents for pipelines.
+##################
+.PHONY: docs-pipeline
+docs-pipeline:
+	@cd pkg/build/pipelines && \
+		go run ../../../docs/cmd/pipeline-reference-gen/main.go --pipeline-dir .
+
 ##################
 # help
 ##################