diff --git a/docs/reference/operator_parameters.md b/docs/reference/operator_parameters.md
index 98d1c2070..2217d87bb 100644
--- a/docs/reference/operator_parameters.md
+++ b/docs/reference/operator_parameters.md
@@ -265,11 +265,11 @@ configuration they are grouped under the `kubernetes` key.
   Default is true.
 
 * **enable_cross_namespace_secrets**
-  To create secrets in a different namespace other than the cluster namespace,
-  enable this option. Once, enabled user names of the intented users are to be
-  provided with the namespace in the form `{appnamespace}`.`{username}`. This
-  makes everything before the first `.` namespace where the secret for that
-  user has to be created and everything after that as the username.
+  To allow secrets in a different namespace other than the Postgres cluster
+  namespace. Once enabled, specify the namespace in the user name under the
+  `users` section in the form `{namespace}.{username}`. The operator will then
+  create the user secret in that namespace. The part after the first `.` is
+  considered to be the user name. The default is `false`.
 
 * **enable_init_containers**
   global option to allow for creating init containers in the cluster manifest to