docs: improved docs format (#275)

* docs: improved docs format

PiperOrigin-RevId: 436315342

Source-Link: googleapis/googleapis@321e5e4

Source-Link: googleapis/googleapis-gen@c7fc4e3
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzdmYzRlMzU0ZmUyZmIyODk2ZDNkMDI0Y2M4YmQ2Mzc4MzZjZWQzZiJ9

* 🦉 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>

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/session.py

@@ -435,18 +435,13 @@ class QueryParameters(proto.Message):
 
             -  MapKey type: string
             -  MapKey value: parameter name
-            -  MapValue type:
-
-               -  If parameter's entity type is a composite entity: map
-               -  Else: depending on parameter value type, could be one
-                  of string, number, boolean, null, list or map
-
-            -  MapValue value:
-
-               -  If parameter's entity type is a composite entity: map
-                  from composite entity property names to property
-                  values
-               -  Else: parameter value
+            -  MapValue type: If parameter's entity type is a composite
+               entity then use map, otherwise, depending on the
+               parameter value type, it could be one of string, number,
+               boolean, null, list or map.
+            -  MapValue value: If parameter's entity type is a composite
+               entity then use map from composite entity property names
+               to property values, otherwise, use parameter value.
         current_page (str):
             The unique identifier of the
             [page][google.cloud.dialogflow.cx.v3.Page] to override the
@@ -620,18 +615,13 @@ class QueryResult(proto.Message):
 
             -  MapKey type: string
             -  MapKey value: parameter name
-            -  MapValue type:
-
-               -  If parameter's entity type is a composite entity: map
-               -  Else: depending on parameter value type, could be one
-                  of string, number, boolean, null, list or map
-
-            -  MapValue value:
-
-               -  If parameter's entity type is a composite entity: map
-                  from composite entity property names to property
-                  values
-               -  Else: parameter value
+            -  MapValue type: If parameter's entity type is a composite
+               entity then use map, otherwise, depending on the
+               parameter value type, it could be one of string, number,
+               boolean, null, list or map.
+            -  MapValue value: If parameter's entity type is a composite
+               entity then use map from composite entity property names
+               to property values, otherwise, use parameter value.
         response_messages (Sequence[google.cloud.dialogflowcx_v3.types.ResponseMessage]):
             The list of rich messages returned to the
             client. Responses vary from simple text messages
@@ -805,25 +795,22 @@ class Match(proto.Message):
             [``NO_INPUT``][google.cloud.dialogflow.cx.v3.Match.MatchType]
             match types.
         parameters (google.protobuf.struct_pb2.Struct):
-            The collection of parameters extracted from
-            the query.
-            Depending on your protocol or client library
-            language, this is a map, associative array,
-            symbol table, dictionary, or JSON object
-            composed of a collection of (MapKey, MapValue)
+            The collection of parameters extracted from the query.
+
+            Depending on your protocol or client library language, this
+            is a map, associative array, symbol table, dictionary, or
+            JSON object composed of a collection of (MapKey, MapValue)
             pairs:
-            -   MapKey type: string
-            -   MapKey value: parameter name
-            -   MapValue type:
-                -   If parameter's entity type is a
-            composite entity: map     -   Else: depending on
-            parameter value type, could be one of string,
-            number, boolean, null, list or map
-            -   MapValue value:
-                -   If parameter's entity type is a
-            composite entity:         map from composite
-            entity property names to property values     -
-            Else: parameter value
+
+            -  MapKey type: string
+            -  MapKey value: parameter name
+            -  MapValue type: If parameter's entity type is a composite
+               entity then use map, otherwise, depending on the
+               parameter value type, it could be one of string, number,
+               boolean, null, list or map.
+            -  MapValue value: If parameter's entity type is a composite
+               entity then use map from composite entity property names
+               to property values, otherwise, use parameter value.
         resolved_input (str):
             Final text input which was matched during
             MatchIntent. This value can be different from

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/types/webhook.py

@@ -99,22 +99,20 @@ class GenericWebService(proto.Message):
                 The HTTP request headers to send together
                 with webhook requests.
             allowed_ca_certs (Sequence[bytes]):
-                Optional. Specifies a list of allowed custom
-                CA certificates (in DER format) for HTTPS
-                verification. This overrides the default SSL
-                trust store. If this is empty or unspecified,
-                Dialogflow will use Google's default trust store
-                to verify certificates.
-                N.B. Make sure the HTTPS server certificates are
-                signed with "subject alt name". For instance a
-                certificate can be self-signed using the
-                following command,
-                   openssl x509 -req -days 200 -in
-                example.com.csr \      -signkey example.com.key
-                \
-                     -out example.com.crt \
-                     -extfile <(printf
-                "\nsubjectAltName='DNS:www.example.com'")
+                Optional. Specifies a list of allowed custom CA certificates
+                (in DER format) for HTTPS verification. This overrides the
+                default SSL trust store. If this is empty or unspecified,
+                Dialogflow will use Google's default trust store to verify
+                certificates. N.B. Make sure the HTTPS server certificates
+                are signed with "subject alt name". For instance a
+                certificate can be self-signed using the following command,
+
+                ::
+
+                      openssl x509 -req -days 200 -in example.com.csr \
+                        -signkey example.com.key \
+                        -out example.com.crt \
+                        -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")
         """
 
         uri = proto.Field(proto.STRING, number=1,)