Re-organize the notes about upgrading the CRDs

Author: rnishtala-sumo

docs/send-data/kubernetes/v4/how-to-upgrade.md

@@ -80,14 +80,6 @@ kube-prometheus-stack:
 
 #### Update custom resource definition for OpenTelemetry operator
 
-```shell
-kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetry.io_opampbridges.yaml
-
-kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetryinstrumentation.yaml
-
-kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetrycollector.yaml`
-```
-
 :::note
 Starting v4.12.0, please use the CRDs below
 :::
@@ -98,13 +90,29 @@ kubectl apply --server-side -f https://raw.githubusercontent.com/SumoLogic/sumol
 kubectl apply --server-side -f https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/refs/tags/v4.12.0/deploy/helm/sumologic/crds/crd-opentelemetrycollector.yaml --force-conflicts
 
 kubectl apply --server-side -f https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/refs/tags/v4.12.0/deploy/helm/sumologic/crds/crd-opentelemetryinstrumentation.yaml --force-conflicts
+```
 
+Then, annotate and label these CRDs as below
+
+```shell
 kubectl annotate crds instrumentations.opentelemetry.io opentelemetrycollectors.opentelemetry.io opampbridges.opentelemetry.io \
   meta.helm.sh/release-name=${RELEASE_NAME} \
   meta.helm.sh/release-namespace=${RELEASE_NAMESPACE}
 kubectl label crds instrumentations.opentelemetry.io opentelemetrycollectors.opentelemetry.io opampbridges.opentelemetry.io app.kubernetes.io/managed-by=Helm
 ```
 
+:::note
+CRDs prior to v4.12.0 are below
+:::
+
+```shell
+kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetry.io_opampbridges.yaml
+
+kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetryinstrumentation.yaml
+
+kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetrycollector.yaml`
+```
+
 ### How to revert to the v3 defaults
 
 Set the following in your configuration:

docs/send-data/kubernetes/v4/important-changes.md

@@ -37,7 +37,7 @@ Ensure that the following CRDs from the OpenTelemetry operator are installed and
 Please follow instructions below to install the appropriate CRD versions
 :::
 
-#### CRDS to install (v4.12.0 and later)
+#### CRDs to install (v4.12.0 and later)
 
 ```shell
 kubectl delete crd instrumentations.opentelemetry.io
@@ -53,6 +53,15 @@ kubectl apply --server-side -f https://raw.githubusercontent.com/SumoLogic/sumol
 kubectl apply --server-side -f https://raw.githubusercontent.com/SumoLogic/sumologic-kubernetes-collection/refs/tags/v4.12.0/deploy/helm/sumologic/crds/crd-opentelemetryinstrumentation.yaml --force-conflicts
 ```
 
+Then, annotate and label these CRDs as below
+
+```shell
+kubectl annotate crds instrumentations.opentelemetry.io opentelemetrycollectors.opentelemetry.io opampbridges.opentelemetry.io \
+  meta.helm.sh/release-name=${RELEASE_NAME} \
+  meta.helm.sh/release-namespace=${RELEASE_NAMESPACE}
+kubectl label crds instrumentations.opentelemetry.io opentelemetrycollectors.opentelemetry.io opampbridges.opentelemetry.io app.kubernetes.io/managed-by=Helm
+```
+
 #### CRDs to install (before v4.12.0)
 
 ```shell