docs: Minor formatting

Google APIs · copybara-github · commit f48d1a329db8 · 2023-08-02T04:07:42.000-07:00
PiperOrigin-RevId: 553099804
diff --git a/google/iam/v1/policy.proto b/google/iam/v1/policy.proto
@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -46,6 +46,7 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 //
 // **JSON example:**
 //
+// ```
 //     {
 //       "bindings": [
 //         {
@@ -73,9 +74,11 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 //       "etag": "BwWWja0YfJA=",
 //       "version": 3
 //     }
+// ```
 //
 // **YAML example:**
 //
+// ```
 //     bindings:
 //     - members:
 //       - user:mike@example.com
@@ -92,6 +95,7 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 //         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
 //     etag: BwWWja0YfJA=
 //     version: 3
+// ```
 //
 // For a description of IAM and its features, see the
 // [IAM documentation](https://cloud.google.com/iam/docs/).
@@ -159,7 +163,7 @@ message Binding {
   // For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
   string role = 1;
 
-  // Specifies the principals requesting access for a Cloud Platform resource.
+  // Specifies the principals requesting access for a Google Cloud resource.
   // `members` can have the following values:
   //
   // * `allUsers`: A special identifier that represents anyone who is
@@ -269,8 +273,8 @@ message Binding {
 //     }
 //
 // For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-// logging. It also exempts jose@example.com from DATA_READ logging, and
-// aliya@example.com from DATA_WRITE logging.
+// logging. It also exempts `jose@example.com` from DATA_READ logging, and
+// `aliya@example.com` from DATA_WRITE logging.
 message AuditConfig {
   // Specifies a service that will be enabled for audit logging.
   // For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
@@ -360,7 +364,7 @@ message BindingDelta {
   // Required
   string role = 2;
 
-  // A single identity requesting access for a Cloud Platform resource.
+  // A single identity requesting access for a Google Cloud resource.
   // Follows the same format of Binding.members.
   // Required
   string member = 3;
