docs: minor comments updates

Google APIs · copybara-github · commit e4009041e691 · 2023-11-21T10:26:19.000-08:00
PiperOrigin-RevId: 584363225
diff --git a/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto b/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto
@@ -295,15 +295,14 @@ message AnnotateAssessmentRequest {
   // whether the event is legitimate or fraudulent.
   Annotation annotation = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Optional reasons for the annotation that will be assigned to the
-  // Event.
+  // Optional. Reasons for the annotation that are assigned to the event.
   repeated Reason reasons = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Optional unique stable hashed user identifier to apply to the
-  // assessment. This is an alternative to setting the hashed_account_id in
-  // CreateAssessment, for example when the account identifier is not yet known
-  // in the initial request. It is recommended that the identifier is hashed
-  // using hmac-sha256 with stable secret.
+  // Optional. Unique stable hashed user identifier to apply to the assessment.
+  // This is an alternative to setting the `hashed_account_id` in
+  // `CreateAssessment`, for example, when the account identifier is not yet
+  // known in the initial request. It is recommended that the identifier is
+  // hashed using hmac-sha256 with stable secret.
   bytes hashed_account_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If the assessment is part of a payment transaction, provide
@@ -435,7 +434,6 @@ message Event {
 }
 
 // Transaction data associated with a payment protected by reCAPTCHA Enterprise.
-// All fields are optional.
 message TransactionData {
   // Structured address format for billing and shipping addresses.
   message Address {
