docs(Speech to Text): Add generated comment updates

Author: lpatino10

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/AddAudioOptions.java

@@ -312,8 +312,8 @@ public String containedContentType() {
    * Gets the allowOverwrite.
    *
    * If `true`, the specified corpus or audio resource overwrites an existing corpus or audio resource with the same
-   * name. If `false` (the default), the request fails if a corpus or audio resource with the same name already exists.
-   * The parameter has no effect if a corpus or audio resource with the same name does not already exist.
+   * name. If `false`, the request fails if a corpus or audio resource with the same name already exists. The parameter
+   * has no effect if a corpus or audio resource with the same name does not already exist.
    *
    * @return the allowOverwrite
    */

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/CreateJobOptions.java

@@ -685,10 +685,10 @@ public Long inactivityTimeout() {
   /**
    * Gets the keywords.
    *
-   * An array of keyword strings to spot in the audio. Each keyword string can include one or more tokens. Keywords are
-   * spotted only in the final results, not in interim hypotheses. If you specify any keywords, you must also specify a
-   * keywords threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify an empty array if you do
-   * not need to spot keywords.
+   * An array of keyword strings to spot in the audio. Each keyword string can include one or more string tokens.
+   * Keywords are spotted only in the final results, not in interim hypotheses. If you specify any keywords, you must
+   * also specify a keywords threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify an empty
+   * array if you do not need to spot keywords.
    *
    * @return the keywords
    */
@@ -700,7 +700,7 @@ public List<String> keywords() {
    * Gets the keywordsThreshold.
    *
    * A confidence value that is the lower bound for spotting a keyword. A word is considered to match a keyword if its
-   * confidence is greater than or equal to the threshold. Specify a probability between 0 and 1 inclusive. No keyword
+   * confidence is greater than or equal to the threshold. Specify a probability between 0.0 and 1.0. No keyword
    * spotting is performed if you omit the parameter. If you specify a threshold, you must also specify one or more
    * keywords.
    *
@@ -713,7 +713,8 @@ public Float keywordsThreshold() {
   /**
    * Gets the maxAlternatives.
    *
-   * The maximum number of alternative transcripts to be returned. By default, a single transcription is returned.
+   * The maximum number of alternative transcripts that the service is to return. By default, a single transcription is
+   * returned.
    *
    * @return the maxAlternatives
    */
@@ -726,8 +727,7 @@ public Long maxAlternatives() {
    *
    * A confidence value that is the lower bound for identifying a hypothesis as a possible word alternative (also known
    * as "Confusion Networks"). An alternative word is considered if its confidence is greater than or equal to the
-   * threshold. Specify a probability between 0 and 1 inclusive. No alternative words are computed if you omit the
-   * parameter.
+   * threshold. Specify a probability between 0.0 and 1.0. No alternative words are computed if you omit the parameter.
    *
    * @return the wordAlternativesThreshold
    */
@@ -738,8 +738,8 @@ public Float wordAlternativesThreshold() {
   /**
    * Gets the wordConfidence.
    *
-   * If `true`, a confidence measure in the range of 0 to 1 is returned for each word. By default, no word confidence
-   * measures are returned.
+   * If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for each word. By default, no word
+   * confidence measures are returned.
    *
    * @return the wordConfidence
    */
@@ -750,7 +750,7 @@ public Boolean wordConfidence() {
   /**
    * Gets the timestamps.
    *
-   * If `true`, time alignment is returned for each word. By default, no timestamps are returned.
+   * If `true`, the service returns time alignment for each word. By default, no timestamps are returned.
    *
    * @return the timestamps
    */
@@ -761,7 +761,7 @@ public Boolean timestamps() {
   /**
    * Gets the profanityFilter.
    *
-   * If `true` (the default), filters profanity from all output except for keyword results by replacing inappropriate
+   * If `true`, the service filters profanity from all output except for keyword results by replacing inappropriate
    * words with a series of asterisks. Set the parameter to `false` to return results with no censoring. Applies to US
    * English transcription only.
    *
@@ -774,10 +774,10 @@ public Boolean profanityFilter() {
   /**
    * Gets the smartFormatting.
    *
-   * If `true`, converts dates, times, series of digits and numbers, phone numbers, currency values, and internet
-   * addresses into more readable, conventional representations in the final transcript of a recognition request. For US
-   * English, also converts certain keyword strings to punctuation symbols. By default, no smart formatting is
-   * performed. Applies to US English and Spanish transcription only.
+   * If `true`, the service converts dates, times, series of digits and numbers, phone numbers, currency values, and
+   * internet addresses into more readable, conventional representations in the final transcript of a recognition
+   * request. For US English, the service also converts certain keyword strings to punctuation symbols. By default, no
+   * smart formatting is performed. Applies to US English and Spanish transcription only.
    *
    * @return the smartFormatting
    */

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/KeywordResult.java

@@ -64,7 +64,7 @@ public Double getEndTime() {
   /**
    * Gets the confidence.
    *
-   * A confidence score for the keyword match in the range of 0 to 1.
+   * A confidence score for the keyword match in the range of 0.0 to 1.0.
    *
    * @return the confidence
    */

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/SpeakerLabelsResult.java

@@ -66,7 +66,7 @@ public Long getSpeaker() {
   /**
    * Gets the confidence.
    *
-   * A score that indicates the service's confidence in its identification of the speaker in the range of 0 to 1.
+   * A score that indicates the service's confidence in its identification of the speaker in the range of 0.0 to 1.0.
    *
    * @return the confidence
    */

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/SpeechRecognitionAlternative.java

@@ -24,9 +24,9 @@ public class SpeechRecognitionAlternative extends GenericModel {
 
   private String transcript;
   private Double confidence;
-  private List<SpeechTimestamp> timestamps;
+  private List<String> timestamps;
   @SerializedName("word_confidence")
-  private List<SpeechWordConfidence> wordConfidence;
+  private List<String> wordConfidence;
 
   /**
    * Gets the transcript.
@@ -42,7 +42,7 @@ public String getTranscript() {
   /**
    * Gets the confidence.
    *
-   * A score that indicates the service's confidence in the transcript in the range of 0 to 1. Returned only for the
+   * A score that indicates the service's confidence in the transcript in the range of 0.0 to 1.0. Returned only for the
    * best alternative and only with results marked as final.
    *
    * @return the confidence
@@ -55,25 +55,25 @@ public Double getConfidence() {
    * Gets the timestamps.
    *
    * Time alignments for each word from the transcript as a list of lists. Each inner list consists of three elements:
-   * the word followed by its start and end time in seconds. Example: `[["hello",0.0,1.2],["world",1.2,2.5]]`. Returned
-   * only for the best alternative.
+   * the word followed by its start and end time in seconds, for example: `[["hello",0.0,1.2],["world",1.2,2.5]]`.
+   * Returned only for the best alternative.
    *
    * @return the timestamps
    */
-  public List<SpeechTimestamp> getTimestamps() {
+  public List<String> getTimestamps() {
     return timestamps;
   }
 
   /**
    * Gets the wordConfidence.
    *
    * A confidence score for each word of the transcript as a list of lists. Each inner list consists of two elements:
-   * the word and its confidence score in the range of 0 to 1. Example: `[["hello",0.95],["world",0.866]]`. Returned
-   * only for the best alternative and only with results marked as final.
+   * the word and its confidence score in the range of 0.0 to 1.0, for example: `[["hello",0.95],["world",0.866]]`.
+   * Returned only for the best alternative and only with results marked as final.
    *
    * @return the wordConfidence
    */
-  public List<SpeechWordConfidence> getWordConfidence() {
+  public List<String> getWordConfidence() {
     return wordConfidence;
   }
 }

speech-to-text/src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/WordAlternativeResult.java

@@ -25,7 +25,7 @@ public class WordAlternativeResult extends GenericModel {
   /**
    * Gets the confidence.
    *
-   * A confidence score for the word alternative hypothesis in the range of 0 to 1.
+   * A confidence score for the word alternative hypothesis in the range of 0.0 to 1.0.
    *
    * @return the confidence
    */