restructure Required Kubernetes Snapshot Components readme section

Author: disperate

CHANGELOG.md

@@ -1,17 +1,17 @@
 ## unreleased
 
 ## v4.0.0-beta1 - 2026.02.27
-⚠️ **Breaking change for snapshot users**  
-This release **requires** Kubernetes VolumeSnapshot CRDs and the external snapshot controller to be installed **before** installing or upgrading this driver. Clusters without these components must install them first; otherwise snapshot-related operations (and the Helm chart’s snapshot resources) will fail to work.
+⚠️ See the [update instructions](https://github.com/cloudscale-ch/csi-cloudscale#from-csi-cloudscale-v3x-to-v4x).
 
-* Add CSI snapshot support, including create/delete, list, and creating volumes from snapshots, with improved error handling and idempotency (for example around size mismatches and existing snapshots).
-* Add `VolumeSnapshotClass` and other snapshot-related resources to the Helm chart and examples; when using Helm, snapshot classes are now created from the `csi.snapshotClasses` configuration.
-* Document the new snapshot-related preconditions and upgrade notes in the README, focusing on users upgrading from v3.x to v4.x.
-* Update `github.com/cloudscale-ch/cloudscale-go-sdk/v7` to `v7.0.0`.
+**Breaking change:** This release **requires** Kubernetes VolumeSnapshot CRDs and the external snapshot controller to be installed **before** installing or upgrading this driver. Clusters without these components must install them first. Otherwise, snapshot-related operations and the snapshot resource in the Helm chart will fail to work.
+
+* Add CSI snapshot support, including create, delete, list, and creating volumes from snapshots.
+* Add `VolumeSnapshotClass` and other snapshot-related resources to the Helm chart and examples. When using Helm, snapshot classes are now created from the `csi.snapshotClasses` configuration.
+* Cleaned up RBAC rules in Helm chart.
+* Update `github.com/cloudscale-ch/cloudscale-go-sdk` fron `v6.0.1` to `v7.0.0`.
 * Bump `google.golang.org/grpc` from `v1.77.0` to `v1.79.1`.
 * Bump `github.com/sirupsen/logrus` from `v1.9.3` to `v1.9.4`.
 * Bump `golang.org/x/sys` from `v0.39.0` to `v0.41.0`.
-* Refine the Helm chart, RBAC and example manifests (including LUKS examples), and simplify snapshot installation instructions using kustomize.
 
 ## v3.6.0 - 2026.01.15
 

README.md

@@ -116,12 +116,11 @@ on `quay.io` and `k8s.gcr.io` container registries. Use `registry.k8s.io` instea
 * If you want to use LUKS encrypted volumes, the kernel on your nodes must have support for 
   `device mapper` infrastructure with the `crypt target` and the appropriate cryptographic APIs
 
-### Required Kubernetes Snapshot Components
-
-Clusters running this driver version must have the
-VolumeSnapshot CRDs and snapshot controller installed.
-Some Kubernetes distributions already include these CRDs and controllers. You only need to apply them manually if your cluster does not provide them.
+#### 1. Required Kubernetes Snapshot Components
 
+Clusters running this driver version must have the VolumeSnapshot CRDs and snapshot controller installed.
+Some Kubernetes distributions already include these CRDs and controllers. 
+You only need to apply them manually if your cluster does not provide them.
 
 Install the snapshot resources using kustomize (recommended):
 ```
@@ -132,7 +131,7 @@ kubectl apply -k https://github.com/kubernetes-csi/external-snapshotter/deploy/k
 When installing using the Helm chart, the `VolumeSnapshotClass` resources are created by the chart based on the `csi.snapshotClasses`
 configuration in `values.yaml`.
 
-#### 1. Create a secret with your cloudscale.ch API Access Token:
+#### 2. Create a secret with your cloudscale.ch API Access Token:
 
 Replace the placeholder string starting with `a05...` with your own secret and
 save it as `secret.yml`: 
@@ -163,14 +162,14 @@ default-token-jskxx   kubernetes.io/service-account-token   3         18h
 cloudscale            Opaque                                1         18h
 ```
 
-#### 2. Deploy the CSI plugin and sidecars:
+#### 3. Deploy the CSI plugin and sidecars:
 
 You can install the CSI plugin and sidecars using one of the following methods:
  * Helm (requires a Helm installation)
  * YAML Manifests (only kubectl required)
 
 
-#### 2a. Using Helm:
+#### 3a. Using Helm:
 
 Before you can install the csi-cloudscale chart, you need to add the helm repository:
 
@@ -211,7 +210,7 @@ Note: if you want to test a debug/dev release, you can use the following command
 $ helm install -g -n kube-system --set controller.image.tag=dev --set node.image.tag=dev --set controller.image.pullPolicy=Always --set node.image.pullPolicy=Always ./charts/csi-cloudscale
 ```
 
-#### 2b. Using YAML Manifests:
+#### 3b. Using YAML Manifests:
 
 Before you continue, be sure to checkout to a [tagged
 release](https://github.com/cloudscale-ch/csi-cloudscale/releases). 
@@ -227,7 +226,7 @@ storage class `cloudscale-volume-ssd` is set to **"default"** for dynamic provis
 using multiple storage classes you might want to remove the annotation and re-deploy it. This is
 based on the [recommended mechanism](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/storage/container-storage-interface.md#recommended-mechanism-for-deploying-csi-drivers-on-kubernetes) of deploying CSI drivers on Kubernetes
 
-#### 3. Test and verify:
+#### 4. Test and verify:
 
 Create a PersistentVolumeClaim. This makes sure a volume is created and provisioned on your behalf:
 
@@ -329,7 +328,7 @@ When updating from csi-cloudscale v2.x to v3.x please note the following:
 
 Before upgrading, ensure that the Kubernetes VolumeSnapshot
 CRDs and snapshot controller are installed in the cluster.
-See [Required Kubernetes Snapshot Components](#required-kubernetes-snapshot-components).
+See [Required Kubernetes Snapshot Components](#1-required-kubernetes-snapshot-components).
 
 ## Advanced Configuration
 

examples/kubernetes/luks-encrypted-volumes/README.md

@@ -4,7 +4,7 @@ Demonstrates creating and restoring LUKS-encrypted volumes from snapshots.
 
 ## Prerequisites
 
-- Snapshot CRDs and snapshot controller installed (see [main README](../../../README.md#prerequisites))
+- Snapshot CRDs and snapshot controller installed (see [main README](../../../README.md#1-required-kubernetes-snapshot-components))
 - A suitable `VolumeSnapshotClass` available. When installing the driver via the Helm chart,
   this is created automatically based on the `csi.snapshotClasses` configuration. For other
   installation methods, you must create a `VolumeSnapshotClass` manually.

examples/kubernetes/volume-snapshots/README.md

@@ -4,7 +4,7 @@ Demonstrates creating and restoring volumes from snapshots.
 
 ## Prerequisites
 
-- Snapshot CRDs and snapshot controller installed (see [main README](../../../README.md#prerequisites))
+- Snapshot CRDs and snapshot controller installed (see [main README](../../../README.md#1-required-kubernetes-snapshot-components))
 - A suitable `VolumeSnapshotClass` available. When installing the driver via the Helm chart,
   this is created automatically based on the `csi.snapshotClasses` configuration. For other
   installation methods, you must create a `VolumeSnapshotClass` manually.