chore(25.3.0): Add upgrade intructions using helm

Author: Techassi

modules/ROOT/partials/release-notes/release-25.3.adoc

@@ -145,4 +145,70 @@ Use "stackablectl operator installed" to list installed operators.
 
 ===== Using Helm
 
+Use `helm list` to list the currently installed operators.
+
+You can use the following command to uninstall all operators that are part of the `24.11` release:
+
+[source,console]
+----
+$ helm uninstall airflow-operator commons-operator druid-operator hbase-operator hdfs-operator hive-operator kafka-operator listener-operator nifi-operator opa-operator secret-operator spark-k8s-operator superset-operator trino-operator zookeeper-operator
+release "airflow-operator" uninstalled
+release "commons-operator" uninstalled
+...
+----
+
+Afterward you will need to upgrade the CustomResourceDefinitions (CRDs) installed by the Stackable Platform.
+The reason for this is that helm will uninstall the operators but not the CRDs. This can be done using `kubectl replace`:
+
+[source]
+----
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/airflow-operator/25.3.0/deploy/helm/airflow-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/commons-operator/25.3.0/deploy/helm/commons-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/druid-operator/25.3.0/deploy/helm/druid-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/hbase-operator/25.3.0/deploy/helm/hbase-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/hdfs-operator/25.3.0/deploy/helm/hdfs-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/hive-operator/25.3.0/deploy/helm/hive-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/kafka-operator/25.3.0/deploy/helm/kafka-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/listener-operator/25.3.0/deploy/helm/listener-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/nifi-operator/25.3.0/deploy/helm/nifi-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/opa-operator/25.3.0/deploy/helm/opa-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/secret-operator/25.3.0/deploy/helm/secret-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/spark-k8s-operator/25.3.0/deploy/helm/spark-k8s-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/superset-operator/25.3.0/deploy/helm/superset-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/trino-operator/25.3.0/deploy/helm/trino-operator/crds/crds.yaml
+kubectl replace -f https://raw.githubusercontent.com/stackabletech/zookeeper-operator/25.3.0/deploy/helm/zookeeper-operator/crds/crds.yaml
+----
+
+[source,console]
+----
+customresourcedefinition.apiextensions.k8s.io "airflowclusters.airflow.stackable.tech" replaced
+customresourcedefinition.apiextensions.k8s.io "airflowdbs.airflow.stackable.tech" replaced
+customresourcedefinition.apiextensions.k8s.io "authenticationclasses.authentication.stackable.tech" replaced
+customresourcedefinition.apiextensions.k8s.io "s3connections.s3.stackable.tech" replaced
+...
+----
+
+Install the `25.3` release
+
+[source,console]
+----
+helm repo add stackable-stable https://repo.stackable.tech/repository/helm-stable/
+helm repo update stackable-stable
+helm install --wait airflow-operator stackable-stable/airflow-operator --version 25.3.0
+helm install --wait commons-operator stackable-stable/commons-operator --version 25.3.0
+helm install --wait druid-operator stackable-stable/druid-operator --version 25.3.0
+helm install --wait hbase-operator stackable-stable/hbase-operator --version 25.3.0
+helm install --wait hdfs-operator stackable-stable/hdfs-operator --version 25.3.0
+helm install --wait hive-operator stackable-stable/hive-operator --version 25.3.0
+helm install --wait kafka-operator stackable-stable/kafka-operator --version 25.3.0
+helm install --wait listener-operator stackable-stable/listener-operator --version 25.3.0
+helm install --wait nifi-operator stackable-stable/nifi-operator --version 25.3.0
+helm install --wait opa-operator stackable-stable/opa-operator --version 25.3.0
+helm install --wait secret-operator stackable-stable/secret-operator --version 25.3.0
+helm install --wait spark-k8s-operator stackable-stable/spark-k8s-operator --version 25.3.0
+helm install --wait superset-operator stackable-stable/superset-operator --version 25.3.0
+helm install --wait trino-operator stackable-stable/trino-operator --version 25.3.0
+helm install --wait zookeeper-operator stackable-stable/zookeeper-operator --version 25.3.0
+----
+
 ==== Known issues

modules/contributor/partials/current_adrs.adoc

@@ -31,3 +31,4 @@
 **** xref:adr/ADR032-oidc-support.adoc[]
 **** xref:adr/ADR034-foundation-webhooks-deployment.adoc[]
 **** xref:adr/ADR035-user-info-fetcher.adoc[]
+**** xref:adr/ADR000-crd-versioning.adoc[]