docs: improved docs format (#245)

* docs: improved docs format

PiperOrigin-RevId: 436315342

Source-Link: googleapis/googleapis@321e5e4

Source-Link: https://github.com/googleapis/googleapis-gen/commit/c7fc4e354fe2fb2896d3d024cc8bd637836ced3f
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>

protos/google/cloud/dialogflow/cx/v3/session.proto

@@ -438,16 +438,14 @@ message QueryParameters {
   // 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.
   google.protobuf.Struct parameters = 5;
 
   // The unique identifier of the [page][google.cloud.dialogflow.cx.v3.Page] to override the [current
@@ -573,16 +571,14 @@ message QueryResult {
   // 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.
   google.protobuf.Struct parameters = 3;
 
   // The list of rich messages returned to the client. Responses vary from
@@ -726,16 +722,14 @@ message Match {
   // 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.
   google.protobuf.Struct parameters = 2;
 
   // Final text input which was matched during MatchIntent. This value can be

protos/google/cloud/dialogflow/cx/v3/webhook.proto

@@ -121,10 +121,12 @@ message Webhook {
     // 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'")
+    // ```
     repeated bytes allowed_ca_certs = 5 [(google.api.field_behavior) = OPTIONAL];
   }