add comments

.github/workflows/create-draft-release-reusable.yml

@@ -25,10 +25,10 @@ jobs:
       - name: Write changelog to file
         env:
           VERSION: ${{ inputs.VERSION }}
-        # note: your repository needs to have this file.
-        # running this script should result in the file named CHANGELOG.md.
         shell: bash
         run: |
+          # Note: your repository needs to have this script.
+          # Running this script should result in a file named CHANGELOG.md, located in the base directory.
           ./hack/scripts/create_changelog.sh "${VERSION}"
 
       - name: Print out changelog

.github/workflows/publish-release-reusable.yml

@@ -1,4 +1,4 @@
-name: Publish release
+name: Publish release (reusable)
 
 on:
   workflow_call:

.github/workflows/render-and-upload-manifests-reusbale.yml

@@ -1,4 +1,4 @@
-name: Render and upload manifests
+name: Render and upload manifests (reusable)
 
 on:
   workflow_call:
@@ -33,6 +33,7 @@ jobs:
           VERSION: ${{ inputs.VERSION }}
           CRD_FILE: ${{ inputs.CRD_FILE }}
         shell: bash
+        # Note: your repository needs to have this script.
         run: ./hack/scripts/render_crd.sh "${VERSION}" "${CRD_FILE}"
 
       - name: Print out CR file