diff --git a/charts/prometheus-operator-crds/README.md b/charts/prometheus-operator-crds/README.md
index 4bf1f35a9be7..4a8b4b6efe1f 100644
--- a/charts/prometheus-operator-crds/README.md
+++ b/charts/prometheus-operator-crds/README.md
@@ -48,6 +48,12 @@ helm upgrade [RELEASE_NAME] [CHART] --install
 
 _See [helm upgrade](https://helm.sh/docs/helm/helm_upgrade/) for command documentation._
 
+## Upgrading to v6.0.0
+
+The upgraded chart now the following changes:
+
+* `annotations` value has moved to `crds.annotations`
+
 ## Configuring
 
 See [Customizing the Chart Before Installing](https://helm.sh/docs/intro/using_helm/#customizing-the-chart-before-installing). To see all configurable options with detailed comments, visit the chart's [values.yaml](./values.yaml), or run these configuration commands: