release: Publish the optional configuration example

Make the versioned API discoverable alongside each release. Validate both assets before publishing and direct administrators to check for an existing instance before applying the example.

Refs: #92

Assisted-by: AI
Signed-off-by: HarshwardhanPatil07 <harshpat@redhat.com>

Author: HarshwardhanPatil07

.github/workflows/release.yaml

@@ -83,6 +83,17 @@ jobs:
           echo "version=${VERSION}" >> "${GITHUB_OUTPUT}"
           echo "tag=v${VERSION}" >> "${GITHUB_OUTPUT}"
 
+      - name: Set up Go
+        uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
+        with:
+          go-version-file: go.mod
+          cache: true # zizmor: ignore[cache-poisoning]
+
+      - name: Build and check release manifests
+        env:
+          TAG: ${{ steps.version.outputs.tag }}
+        run: make verify-release-manifest IMG="${IMAGE}:${TAG}"
+
       - name: Create and push tag
         env:
           TAG: ${{ steps.version.outputs.tag }}
@@ -114,12 +125,6 @@ jobs:
             exit 1
           fi
 
-      - name: Set up Go
-        uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
-        with:
-          go-version-file: go.mod
-          cache: true # zizmor: ignore[cache-poisoning]
-
       - name: Build and push container image
         env:
           TAG: ${{ steps.version.outputs.tag }}
@@ -130,11 +135,6 @@ jobs:
           podman login -u "${ACTOR}" -p "${GH_TOKEN}" ghcr.io
           podman push "${IMAGE}:${TAG}"
 
-      - name: Build install manifest
-        env:
-          TAG: ${{ steps.version.outputs.tag }}
-        run: make release-manifest IMG="${IMAGE}:${TAG}"
-
       - name: Package and push Helm charts
         env:
           VERSION: ${{ steps.version.outputs.version }}
@@ -169,6 +169,11 @@ jobs:
             printf 'kubectl apply -f https://github.com/%s/releases/download/%s/install.yaml\n' \
               "${GITHUB_REPOSITORY}" "${TAG}"
             printf '```\n\n'
+            printf 'Optional configuration example: [operator-config.yaml](https://github.com/%s/releases/download/%s/operator-config.yaml). ' \
+              "${GITHUB_REPOSITORY}" "${TAG}"
+            printf 'Before applying it, check for an existing instance; see the [configuration guide](https://github.com/%s/blob/%s/docs/src/operations/configuration.md).\n' \
+              "${GITHUB_REPOSITORY}" "${TAG}"
+            printf '\n'
             printf '### Helm\n\n'
             printf '```bash\n'
             printf 'helm install bootc-operator oci://ghcr.io/%s/charts/bootc-operator --version %s \\\n' \
@@ -181,4 +186,4 @@ jobs:
             --notes-file notes.md \
             --generate-notes \
             --draft \
-            install.yaml
+            install.yaml operator-config.yaml