Add alternative options to update connectionSecretKeys

Co-authored-by: Jared Watts <[email protected]>
Signed-off-by: twobiers <[email protected]>

Author: twobiers

content/master/concepts/connection-details.md

@@ -534,11 +534,10 @@ the secret key names to create. Crossplane only adds the keys listed to the
 combined secret.
 
 {{<hint "warning">}}
-You can't change the 
-{{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}} of an XRD. 
-You must delete and
-recreate the XRD to change the 
-{{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}}.
+When changing the {{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}} of an XRD the change isn't immediately reflected.
+You have two options to change the keys in the combined secret object.
+- Delete and recreate the XRD. This only makes sense if the XRD isn't used as it leads to the deletion of XRs.
+- Restart the XR reconciler, which can be done by restarting the Crossplane pod.
 {{</hint >}}
 
 For example, an XRD may restrict the secrets to only the 

content/v1.19/concepts/connection-details.md

@@ -534,11 +534,10 @@ the secret key names to create. Crossplane only adds the keys listed to the
 combined secret.
 
 {{<hint "warning">}}
-You can't change the 
-{{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}} of an XRD. 
-You must delete and
-recreate the XRD to change the 
-{{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}}.
+When changing the {{<hover label="xrd" line="4">}}connectionSecretKeys{{</hover>}} of an XRD the change isn't immediately reflected.
+You have two options to change the keys in the combined secret object.
+- Delete and recreate the XRD. This only makes sense if the XRD isn't used as it leads to the deletion of XRs.
+- Restart the XR reconciler effectively restarting the Crossplane pods.
 {{</hint >}}
 
 For example, an XRD may restrict the secrets to only the