docs: add build and packaging overview

[migmartri]

Add a high-level overview of how Chainloop is built and packaged: GoReleaser, container images, dependency image rebuilds from Bitnami sources, Helm chart structure, and chart bumping on release.

[cubic-dev-ai]

1 issue found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/build-and-packaging.md">

<violation number="1" location="docs/build-and-packaging.md:112">
P2: Documented make target `build_devel_container_images` doesn't exist — the actual Makefile target is `build_devel_container_mages` (typo, missing 'i'). Anyone following this doc will get an error. Either update the docs to match the Makefile, or (preferably) fix the typo in the Makefile and keep the docs as-is.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: Documented make target build_devel_container_images doesn't exist — the actual Makefile target is build_devel_container_mages (typo, missing 'i'). Anyone following this doc will get an error. Either update the docs to match the Makefile, or (preferably) fix the typo in the Makefile and keep the docs as-is.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At docs/build-and-packaging.md, line 112:

<comment>Documented make target `build_devel_container_images` doesn't exist — the actual Makefile target is `build_devel_container_mages` (typo, missing 'i'). Anyone following this doc will get an error. Either update the docs to match the Makefile, or (preferably) fix the typo in the Makefile and keep the docs as-is.</comment>

<file context>
@@ -0,0 +1,113 @@
+make build_devel
+
+# Build binaries + container images locally (no signing)
+make build_devel_container_images
+```
</file context>

[jiparis]

Thanks!