chore(docs): automatic generate pipeline docs

.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
 ##################

pkg/build/pipelines/cargo/README.md

@@ -16,7 +16,9 @@ Compile an auditable rust binary with Cargo
 | modroot | false | Top directory of the rust package, this is where the target package lives. Before building, the cargo pipeline wil cd into this directory. Defaults to current working directory  | . |
 | opts | false | Options to pass to cargo build. Defaults to release  | --release |
 | output | false | Filename to use when writing the binary. The final install location inside the apk will be in prefix / install-dir / output  |  |
+| output-dir | false | Directory where the binaris will be placed after building. Defaults to target/release  | target/release |
 | prefix | false | Installation prefix. Defaults to usr  | usr |
+| rustflags | false | Rustc flags to be passed to pass to all compiler invocations that Cargo performs. In contrast with cargo rustc, this is useful for passing a flag to all compiler instances. This string is split by whitespace.  |  |
 
 
 <!-- end:pipeline-reference-gen -->