Confusing environment variable with secrets in `google_cloud_run_serv…

…ice` documentation. (#4987) (#3440)

* clarify cloudrun secret

Co-authored-by: upodroid <cy@borg.dev>

* Bit of formatting

Co-authored-by: Cameron Thornton <camthornton@google.com>
Signed-off-by: Modular Magician <magic-modules@google.com>

Co-authored-by: Cameron Thornton <camthornton@google.com>

.changelog/4987.txt

@@ -0,0 +1,3 @@
+```release-note:none
+
+```

google-beta/resource_cloud_run_service.go

@@ -807,12 +807,11 @@ version or an integer for a specific version.`,
 										Description: `The name of the secret in Cloud Secret Manager. By default, the secret
 is assumed to be in the same project.
 If the secret is in another project, you must define an alias.
-An alias definition has the form:
-<alias>:projects/<project-id|project-number>/secrets/<secret-name>.
-If multiple alias definitions are needed, they must be separated by
-commas.
-The alias definitions must be set on the run.googleapis.com/secrets
-annotation.`,
+You set the <alias> in this field, and create an annotation with the
+following structure 
+"run.googleapis.com/secrets" = "<alias>:projects/<project-id|project-number>/secrets/<secret-name>".
+If multiple alias definitions are needed, they must be separated by 
+commas in the annotation field.`,
 									},
 								},
 							},

website/docs/r/cloud_run_service.html.markdown

@@ -769,12 +769,11 @@ The `secret_key_ref` block supports:
   The name of the secret in Cloud Secret Manager. By default, the secret
   is assumed to be in the same project.
   If the secret is in another project, you must define an alias.
-  An alias definition has the form:
-  <alias>:projects/<project-id|project-number>/secrets/<secret-name>.
-  If multiple alias definitions are needed, they must be separated by
-  commas.
-  The alias definitions must be set on the run.googleapis.com/secrets
-  annotation.
+  You set the <alias> in this field, and create an annotation with the
+  following structure 
+  "run.googleapis.com/secrets" = "<alias>:projects/<project-id|project-number>/secrets/<secret-name>".
+  If multiple alias definitions are needed, they must be separated by 
+  commas in the annotation field.
 
 The `ports` block supports: