docs: [dialogflow] Minor formatting

java-dialogflow/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.19.0</version>
+      <version>26.21.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-dialogflow.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow/4.27.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dialogflow/4.28.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-dialogflow/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/ContextOrBuilder.java

@@ -33,7 +33,7 @@ public interface ContextOrBuilder
    * ID>/sessions/<Session ID>/contexts/<Context ID>`.
    *
    * The `Context ID` is always converted to lowercase, may only contain
-   * characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+   * characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long.
    *
    * If `Environment ID` is not specified, we assume default 'draft'
    * environment. If `User ID` is not specified, we assume default '-' user.
@@ -61,7 +61,7 @@ public interface ContextOrBuilder
    * ID>/sessions/<Session ID>/contexts/<Context ID>`.
    *
    * The `Context ID` is always converted to lowercase, may only contain
-   * characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+   * characters in `a-zA-Z0-9_-%` and may be at most 250 bytes long.
    *
    * If `Environment ID` is not specified, we assume default 'draft'
    * environment. If `User ID` is not specified, we assume default '-' user.
@@ -106,16 +106,14 @@ public interface ContextOrBuilder
    * 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.
    * </pre>
    *
    * <code>.google.protobuf.Struct parameters = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -133,16 +131,14 @@ public interface ContextOrBuilder
    * 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.
    * </pre>
    *
    * <code>.google.protobuf.Struct parameters = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -160,16 +156,14 @@ public interface ContextOrBuilder
    * 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.
    * </pre>
    *
    * <code>.google.protobuf.Struct parameters = 3 [(.google.api.field_behavior) = OPTIONAL];</code>

java-dialogflow/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/CreateConversationRequest.java

@@ -190,7 +190,7 @@ public com.google.cloud.dialogflow.v2.ConversationOrBuilder getConversationOrBui
    * auto-generated one to you.
    *
    * The conversation ID must be compliant with the regression fomula
-   * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+   * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
    * If the field is provided, the caller is resposible for
    * 1. the uniqueness of the ID, otherwise the request will be rejected.
    * 2. the consistency for whether to use custom ID or not under a project to
@@ -222,7 +222,7 @@ public java.lang.String getConversationId() {
    * auto-generated one to you.
    *
    * The conversation ID must be compliant with the regression fomula
-   * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+   * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
    * If the field is provided, the caller is resposible for
    * 1. the uniqueness of the ID, otherwise the request will be rejected.
    * 2. the consistency for whether to use custom ID or not under a project to
@@ -979,7 +979,7 @@ public com.google.cloud.dialogflow.v2.ConversationOrBuilder getConversationOrBui
      * auto-generated one to you.
      *
      * The conversation ID must be compliant with the regression fomula
-     * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+     * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
      * If the field is provided, the caller is resposible for
      * 1. the uniqueness of the ID, otherwise the request will be rejected.
      * 2. the consistency for whether to use custom ID or not under a project to
@@ -1010,7 +1010,7 @@ public java.lang.String getConversationId() {
      * auto-generated one to you.
      *
      * The conversation ID must be compliant with the regression fomula
-     * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+     * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
      * If the field is provided, the caller is resposible for
      * 1. the uniqueness of the ID, otherwise the request will be rejected.
      * 2. the consistency for whether to use custom ID or not under a project to
@@ -1041,7 +1041,7 @@ public com.google.protobuf.ByteString getConversationIdBytes() {
      * auto-generated one to you.
      *
      * The conversation ID must be compliant with the regression fomula
-     * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+     * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
      * If the field is provided, the caller is resposible for
      * 1. the uniqueness of the ID, otherwise the request will be rejected.
      * 2. the consistency for whether to use custom ID or not under a project to
@@ -1071,7 +1071,7 @@ public Builder setConversationId(java.lang.String value) {
      * auto-generated one to you.
      *
      * The conversation ID must be compliant with the regression fomula
-     * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+     * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
      * If the field is provided, the caller is resposible for
      * 1. the uniqueness of the ID, otherwise the request will be rejected.
      * 2. the consistency for whether to use custom ID or not under a project to
@@ -1097,7 +1097,7 @@ public Builder clearConversationId() {
      * auto-generated one to you.
      *
      * The conversation ID must be compliant with the regression fomula
-     * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+     * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
      * If the field is provided, the caller is resposible for
      * 1. the uniqueness of the ID, otherwise the request will be rejected.
      * 2. the consistency for whether to use custom ID or not under a project to

java-dialogflow/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/CreateConversationRequestOrBuilder.java

@@ -104,7 +104,7 @@ public interface CreateConversationRequestOrBuilder
    * auto-generated one to you.
    *
    * The conversation ID must be compliant with the regression fomula
-   * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+   * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
    * If the field is provided, the caller is resposible for
    * 1. the uniqueness of the ID, otherwise the request will be rejected.
    * 2. the consistency for whether to use custom ID or not under a project to
@@ -125,7 +125,7 @@ public interface CreateConversationRequestOrBuilder
    * auto-generated one to you.
    *
    * The conversation ID must be compliant with the regression fomula
-   * "[a-zA-Z][a-zA-Z0-9_-]*" with the characters length in range of [3,64].
+   * `[a-zA-Z][a-zA-Z0-9_-]*` with the characters length in range of [3,64].
    * If the field is provided, the caller is resposible for
    * 1. the uniqueness of the ID, otherwise the request will be rejected.
    * 2. the consistency for whether to use custom ID or not under a project to

java-dialogflow/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/DetectIntentRequest.java

@@ -208,12 +208,12 @@ public com.google.cloud.dialogflow.v2.QueryParametersOrBuilder getQueryParamsOrB
    * <pre>
    * Required. The input specification. It can be set to:
    *
-   * 1.  an audio config
-   *     which instructs the speech recognizer how to process the speech audio,
+   * 1. an audio config which instructs the speech recognizer how to process
+   * the speech audio,
    *
-   * 2.  a conversational query in the form of text, or
+   * 2. a conversational query in the form of text, or
    *
-   * 3.  an event that specifies which intent to trigger.
+   * 3. an event that specifies which intent to trigger.
    * </pre>
    *
    * <code>
@@ -232,12 +232,12 @@ public boolean hasQueryInput() {
    * <pre>
    * Required. The input specification. It can be set to:
    *
-   * 1.  an audio config
-   *     which instructs the speech recognizer how to process the speech audio,
+   * 1. an audio config which instructs the speech recognizer how to process
+   * the speech audio,
    *
-   * 2.  a conversational query in the form of text, or
+   * 2. a conversational query in the form of text, or
    *
-   * 3.  an event that specifies which intent to trigger.
+   * 3. an event that specifies which intent to trigger.
    * </pre>
    *
    * <code>
@@ -258,12 +258,12 @@ public com.google.cloud.dialogflow.v2.QueryInput getQueryInput() {
    * <pre>
    * Required. The input specification. It can be set to:
    *
-   * 1.  an audio config
-   *     which instructs the speech recognizer how to process the speech audio,
+   * 1. an audio config which instructs the speech recognizer how to process
+   * the speech audio,
    *
-   * 2.  a conversational query in the form of text, or
+   * 2. a conversational query in the form of text, or
    *
-   * 3.  an event that specifies which intent to trigger.
+   * 3. an event that specifies which intent to trigger.
    * </pre>
    *
    * <code>
@@ -1315,12 +1315,12 @@ public com.google.cloud.dialogflow.v2.QueryParametersOrBuilder getQueryParamsOrB
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1338,12 +1338,12 @@ public boolean hasQueryInput() {
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1367,12 +1367,12 @@ public com.google.cloud.dialogflow.v2.QueryInput getQueryInput() {
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1398,12 +1398,12 @@ public Builder setQueryInput(com.google.cloud.dialogflow.v2.QueryInput value) {
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1427,12 +1427,12 @@ public Builder setQueryInput(
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1461,12 +1461,12 @@ public Builder mergeQueryInput(com.google.cloud.dialogflow.v2.QueryInput value)
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1489,12 +1489,12 @@ public Builder clearQueryInput() {
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1512,12 +1512,12 @@ public com.google.cloud.dialogflow.v2.QueryInput.Builder getQueryInputBuilder()
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>
@@ -1539,12 +1539,12 @@ public com.google.cloud.dialogflow.v2.QueryInputOrBuilder getQueryInputOrBuilder
      * <pre>
      * Required. The input specification. It can be set to:
      *
-     * 1.  an audio config
-     *     which instructs the speech recognizer how to process the speech audio,
+     * 1. an audio config which instructs the speech recognizer how to process
+     * the speech audio,
      *
-     * 2.  a conversational query in the form of text, or
+     * 2. a conversational query in the form of text, or
      *
-     * 3.  an event that specifies which intent to trigger.
+     * 3. an event that specifies which intent to trigger.
      * </pre>
      *
      * <code>