docs: [iam] Minor formatting (#1902)

* docs: Minor formatting PiperOrigin-RevId: 553099804 Source-Link: googleapis/googleapis@f48d1a3 Source-Link: https://github.com/googleapis/googleapis-gen/commit/9607990f4c3217bac6edd8131614cfcc71744a6f Copy-Tag: eyJwIjoiamF2YS1pYW0vLk93bEJvdC55YW1sIiwiaCI6Ijk2MDc5OTBmNGMzMjE3YmFjNmVkZDgxMzE2MTRjZmNjNzE3NDRhNmYifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * docs: Minor formatting PiperOrigin-RevId: 553099804 Source-Link: googleapis/googleapis@f48d1a3 Source-Link: https://github.com/googleapis/googleapis-gen/commit/9607990f4c3217bac6edd8131614cfcc71744a6f Copy-Tag: eyJwIjoiamF2YS1pYW0vLk93bEJvdC55YW1sIiwiaCI6Ijk2MDc5OTBmNGMzMjE3YmFjNmVkZDgxMzE2MTRjZmNjNzE3NDRhNmYifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Aug 29, 2023 · 5ec1142 · 5ec1142
1 parent e0d2326
commit 5ec1142
Show file tree

Hide file tree

Showing 6 changed files with 38 additions and 30 deletions.
diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/AuditConfig.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/AuditConfig.java
@@ -71,8 +71,8 @@
  *     }
  *
  * For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
- * logging. It also exempts jose&#64;example.com from DATA_READ logging, and
- * aliya&#64;example.com from DATA_WRITE logging.
+ * logging. It also exempts `jose&#64;example.com` from DATA_READ logging, and
+ * `aliya&#64;example.com` from DATA_WRITE logging.
  * </pre>
  *
  * Protobuf type {@code google.iam.v1.AuditConfig}
@@ -458,8 +458,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *     }
    *
    * For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-   * logging. It also exempts jose&#64;example.com from DATA_READ logging, and
-   * aliya&#64;example.com from DATA_WRITE logging.
+   * logging. It also exempts `jose&#64;example.com` from DATA_READ logging, and
+   * `aliya&#64;example.com` from DATA_WRITE logging.
    * </pre>
    *
    * Protobuf type {@code google.iam.v1.AuditConfig}

diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/Binding.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/Binding.java
@@ -122,7 +122,7 @@ public com.google.protobuf.ByteString getRoleBytes() {
    *
    *
    * <pre>
-   * 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
@@ -177,7 +177,7 @@ public com.google.protobuf.ProtocolStringList getMembersList() {
    *
    *
    * <pre>
-   * 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
@@ -232,7 +232,7 @@ public int getMembersCount() {
    *
    *
    * <pre>
-   * 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
@@ -288,7 +288,7 @@ public java.lang.String getMembers(int index) {
    *
    *
    * <pre>
-   * 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
@@ -947,7 +947,7 @@ private void ensureMembersIsMutable() {
      *
      *
      * <pre>
-     * 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
@@ -1003,7 +1003,7 @@ public com.google.protobuf.ProtocolStringList getMembersList() {
      *
      *
      * <pre>
-     * 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
@@ -1058,7 +1058,7 @@ public int getMembersCount() {
      *
      *
      * <pre>
-     * 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
@@ -1114,7 +1114,7 @@ public java.lang.String getMembers(int index) {
      *
      *
      * <pre>
-     * 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
@@ -1170,7 +1170,7 @@ public com.google.protobuf.ByteString getMembersBytes(int index) {
      *
      *
      * <pre>
-     * 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
@@ -1234,7 +1234,7 @@ public Builder setMembers(int index, java.lang.String value) {
      *
      *
      * <pre>
-     * 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
@@ -1297,7 +1297,7 @@ public Builder addMembers(java.lang.String value) {
      *
      *
      * <pre>
-     * 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
@@ -1357,7 +1357,7 @@ public Builder addAllMembers(java.lang.Iterable<java.lang.String> values) {
      *
      *
      * <pre>
-     * 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
@@ -1416,7 +1416,7 @@ public Builder clearMembers() {
      *
      *
      * <pre>
-     * 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

diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingDelta.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingDelta.java
@@ -320,7 +320,7 @@ public com.google.protobuf.ByteString getRoleBytes() {
    *
    *
    * <pre>
-   * 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
    * </pre>
@@ -345,7 +345,7 @@ public java.lang.String getMember() {
    *
    *
    * <pre>
-   * 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
    * </pre>
@@ -1042,7 +1042,7 @@ public Builder setRoleBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * 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
      * </pre>
@@ -1066,7 +1066,7 @@ public java.lang.String getMember() {
      *
      *
      * <pre>
-     * 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
      * </pre>
@@ -1090,7 +1090,7 @@ public com.google.protobuf.ByteString getMemberBytes() {
      *
      *
      * <pre>
-     * 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
      * </pre>
@@ -1113,7 +1113,7 @@ public Builder setMember(java.lang.String value) {
      *
      *
      * <pre>
-     * 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
      * </pre>
@@ -1132,7 +1132,7 @@ public Builder clearMember() {
      *
      *
      * <pre>
-     * 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
      * </pre>

diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingDeltaOrBuilder.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingDeltaOrBuilder.java
@@ -83,7 +83,7 @@ public interface BindingDeltaOrBuilder
    *
    *
    * <pre>
-   * 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
    * </pre>
@@ -97,7 +97,7 @@ public interface BindingDeltaOrBuilder
    *
    *
    * <pre>
-   * 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
    * </pre>

diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingOrBuilder.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/BindingOrBuilder.java
@@ -54,7 +54,7 @@ public interface BindingOrBuilder
    *
    *
    * <pre>
-   * 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
@@ -107,7 +107,7 @@ public interface BindingOrBuilder
    *
    *
    * <pre>
-   * 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
@@ -160,7 +160,7 @@ public interface BindingOrBuilder
    *
    *
    * <pre>
-   * 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
@@ -214,7 +214,7 @@ public interface BindingOrBuilder
    *
    *
    * <pre>
-   * 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

diff --git a/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/Policy.java b/java-iam/proto-google-iam-v1/src/main/java/com/google/iam/v1/Policy.java
@@ -42,6 +42,7 @@
  *
  * **JSON example:**
  *
+ * ```
  *     {
  *       "bindings": [
  *         {
@@ -69,9 +70,11 @@
  *       "etag": "BwWWja0YfJA=",
  *       "version": 3
  *     }
+ * ```
  *
  * **YAML example:**
  *
+ * ```
  *     bindings:
  *     - members:
  *       - user:mike&#64;example.com
@@ -88,6 +91,7 @@
  *         expression: request.time &lt; 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/).
@@ -598,6 +602,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    * **JSON example:**
    *
+   * ```
    *     {
    *       "bindings": [
    *         {
@@ -625,9 +630,11 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *       "etag": "BwWWja0YfJA=",
    *       "version": 3
    *     }
+   * ```
    *
    * **YAML example:**
    *
+   * ```
    *     bindings:
    *     - members:
    *       - user:mike&#64;example.com
@@ -644,6 +651,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *         expression: request.time &lt; 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/).