chore(charts): correct stale release guidance in comments and charts/README

The artifacthub.io/changes comments told the reader to keep the list in step
with the changelog's [Unreleased] section, which no longer exists under Release
Please. They now state the real hazard: Release Please bumps `version:` but does
not touch this annotation, so it silently ends up describing the previous
release unless it is updated in the release PR.

charts/README.md pointed at release.sh as recommended; it now points at
RELEASE.md and notes that release.sh follows the older convention.

Deliberately `chore:` so it stays hidden and opens no release PR — comments and
a directory README are not user-facing chart changes.

Author: attilaedelenyi

charts/README.md

@@ -8,61 +8,24 @@ This directory contains the maintained Helm charts published from this repositor
 
 ## Releasing Charts
 
-Charts are released from Git tags via GitHub Actions.
+**See [`RELEASE.md`](../RELEASE.md) for the full process.** In short: charts are released by
+**Release Please**, which opens one release PR per chart on every push to `master`. Merging that PR
+tags, releases, and publishes the chart. You do not edit versions or changelogs by hand.
 
-Preferred distribution is the GitHub Pages Helm repository:
+Which chart a commit releases is decided by the **file paths it touches**, not by the commit scope,
+so keep a commit to one chart where you can.
 
-```bash
-helm repo add ontoserver https://aehrc.github.io/ontoserver-deploy
-```
-
-Release tags must match the workflow triggers in `.github/workflows/release.yml`:
-
-- `ontoserver-vX.Y.Z`
-- `ontoserver-extras-vX.Y.Z`
-- `ontoserver-indexer-vX.Y.Z`
-
-Pushing one of those tags triggers the chart release workflow, which:
-
-- publishes the chart to the GitHub Pages Helm repository via `chart-releaser-action`
-- updates `artifacthub-repo.yml` on the `gh-pages` branch
-- pushes the packaged chart to `ghcr.io/aehrc` as a secondary OCI artifact
-
-### Using release.sh (recommended)
-
-Use `release.sh` to automate the full release cycle — tagging the current version, triggering the release workflow, then bumping `Chart.yaml` for the next cycle:
-
-```bash
-# Interactive — tags current version, prompts for next (default: minor bump)
-./charts/release.sh ontoserver
-
-# Fully automated minor bump, no prompt
-./charts/release.sh ontoserver --auto-increment
-
-# Patch or major bump
-./charts/release.sh ontoserver --patch
-./charts/release.sh ontoserver --major
-
-# Set next version explicitly
-./charts/release.sh ontoserver --next-version 1.0.0
-
-# Preview without making changes
-./charts/release.sh ontoserver --dry-run
-```
-
-Replace `ontoserver` with `ontoserver-extras` or `ontoserver-indexer` for the other charts.
-
-### Manual release (alternative)
+Distribution:
 
 ```bash
-git tag ontoserver-v0.1.0
-git push origin ontoserver-v0.1.0
+helm repo add ontoserver https://aehrc.github.io/ontoserver-deploy
+helm install my-ontoserver ontoserver/ontoserver -f your-values.yaml
 ```
 
-After the first release, confirm:
-
-- GitHub Pages is enabled for the `gh-pages` branch
-- the new chart version appears in the Helm repo index
+`release.sh` and the tag-triggered `.github/workflows/release.yml` are retained for manual releases
+and recovery only — note that `release.sh` still follows the **older** convention where `Chart.yaml`
+holds the in-development version, so using it leaves `.release-please-manifest.json` out of step.
+`RELEASE.md` covers both, plus recovery steps.
 - the corresponding `ghcr.io` package visibility is set as intended
 
 ## Releasing Varnish Exporter

charts/ontoserver-extras/Chart.yaml

@@ -20,7 +20,8 @@ maintainers:
 annotations:
   artifacthub.io/category: integration-delivery
   artifacthub.io/license: Apache-2.0
-  # Describes the version in `version:` above. Keep in step with the changelog's [Unreleased].
+  # Describes the version in `version:` above — the last released version. Release Please bumps
+  # `version:` but does NOT touch this list; update it in the release PR before merging.
   artifacthub.io/changes: |
     - kind: fixed
       description: Varnish now restarts when the VCL changes (checksum/config pod annotation)

charts/ontoserver-indexer/Chart.yaml

@@ -20,6 +20,8 @@ maintainers:
 annotations:
   artifacthub.io/category: integration-delivery
   artifacthub.io/license: Apache-2.0
+  # Describes the version in `version:` above — the last released version. Release Please bumps
+  # `version:` but does NOT touch this list; update it in the release PR before merging.
   artifacthub.io/changes: |
     - kind: added
       description: resources.heapGb to size the JVM heap independently of the container memory limit

charts/ontoserver/Chart.yaml

@@ -19,8 +19,9 @@ maintainers:
 annotations:
   artifacthub.io/category: integration-delivery
   artifacthub.io/license: Apache-2.0
-  # Describes the version in `version:` above, i.e. the release this Chart.yaml will be tagged as.
-  # Keep in step with the changelog's [Unreleased] section.
+  # Describes the version in `version:` above — which is the LAST RELEASED version under Release
+  # Please, not an in-development one. Release Please bumps `version:` but does NOT touch this list,
+  # so update it in the release PR before merging or it will silently describe the previous release.
   artifacthub.io/changes: |
     - kind: added
       description: Opt-in pod and container securityContext values (unset by default, so upgrades roll no pods)