fixup! Move release logic to a new workflow

.github/workflows/build.yaml

@@ -1,5 +1,10 @@
 name: Build, Test, Automerge and Tag
 
+# This workflow runs on all PR that are targetting the main branch.
+#
+# It runs the test suite. If the PR is a release PR, it automerges and tags the main branch with
+# the corresonding new version. Finally, it retags the container image with latest.
+
 on:
     pull_request_target:
         types: [opened, synchronize, reopened]

.github/workflows/release.yaml

@@ -1,5 +1,14 @@
 name: create release on new tags
 
+# This workflow is triggered by new version tags (e.g. "1.12.2") on the main branch.
+#
+# Tagging should be automatic after each merged PR release (see the build.yaml workflow). It can
+# also be manually triggered if needed. Note that the tests are not run by this workflow, so
+# release manually at your own risk. If manually tagging the main branch, the tag must match the
+# version set in ./pkg/chartverifier/version/version_info.json.
+#
+# This workflow builds the tarball, creates the Github release and attaches the tarball to it.
+
 on:
   push:
     # Publish semver tags as releases.