docs: [google-cloud-iap] Add clarifications on IAP CorsSettings behavior (googleapis#13952)

BEGIN_COMMIT_OVERRIDE
docs: Add clarifications on IAP CorsSettings behavior
docs: Minor updates on GcipSettings description
END_COMMIT_OVERRIDE


- [ ] Regenerate this pull request now.

docs: Minor updates on GcipSettings description

PiperOrigin-RevId: 763926233

Source-Link:
googleapis/googleapis@361c494

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/75609aa9c1ad70c59e2b51cb0776ff61950593a4
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWlhcC8uT3dsQm90LnlhbWwiLCJoIjoiNzU2MDlhYTljMWFkNzBjNTllMmI1MWNiMDc3NmZmNjE5NTA1OTNhNCJ9

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-iap/google/cloud/iap_v1/types/service.py

@@ -417,17 +417,19 @@ class IdentitySource(proto.Enum):
 
 
 class GcipSettings(proto.Message):
-    r"""Allows customers to configure tenant_id for GCIP instance per-app.
+    r"""Allows customers to configure tenant IDs for a Cloud Identity
+    Platform (GCIP) instance for each application.
 
     Attributes:
         tenant_ids (MutableSequence[str]):
-            Optional. GCIP tenant ids that are linked to the IAP
-            resource. tenant_ids could be a string beginning with a
+            Optional. GCIP tenant IDs that are linked to the IAP
+            resource. ``tenant_ids`` could be a string beginning with a
             number character to indicate authenticating with GCIP tenant
-            flow, or in the format of \_ to indicate authenticating with
-            GCIP agent flow. If agent flow is used, tenant_ids should
-            only contain one single element, while for tenant flow,
-            tenant_ids can contain multiple elements.
+            flow, or in the format of ``_<ProjectNumber>`` to indicate
+            authenticating with GCIP agent flow. If agent flow is used,
+            ``tenant_ids`` should only contain one single element, while
+            for tenant flow, ``tenant_ids`` can contain multiple
+            elements.
         login_page_uri (google.protobuf.wrappers_pb2.StringValue):
             Login page URI associated with the GCIP
             tenants. Typically, all resources within the
@@ -448,15 +450,14 @@ class GcipSettings(proto.Message):
 
 
 class CorsSettings(proto.Message):
-    r"""Allows customers to configure HTTP request paths that'll
-    allow HTTP OPTIONS call to bypass authentication and
-    authorization.
+    r"""Allows customers to configure HTTP request paths that'll allow HTTP
+    ``OPTIONS`` call to bypass authentication and authorization.
 
     Attributes:
         allow_http_options (google.protobuf.wrappers_pb2.BoolValue):
-            Configuration to allow HTTP OPTIONS calls to
-            skip authorization. If undefined, IAP will not
-            apply any special logic to OPTIONS requests.
+            Configuration to allow HTTP ``OPTIONS`` calls to skip
+            authentication and authorization. If undefined, IAP will not
+            apply any special logic to ``OPTIONS`` requests.
     """
 
     allow_http_options: wrappers_pb2.BoolValue = proto.Field(