chore(wa,dis,lt,nlu,tts): small changes

Author: apaparazzi0329

assistant/v1.ts

@@ -3462,6 +3462,8 @@ class AssistantV1 extends BaseService {
    * filter. For more information, see the
    * [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).
    * @param {number} [params.pageLimit] - The number of records to return in each page of results.
+   *
+   * **Note:** If the API is not returning your data, try lowering the page_limit value.
    * @param {string} [params.cursor] - A token identifying the page of results to retrieve.
    * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
    * @returns {Promise<AssistantV1.Response<AssistantV1.LogCollection>>}
@@ -4904,7 +4906,10 @@ namespace AssistantV1 {
      *  see the [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).
      */
     filter?: string;
-    /** The number of records to return in each page of results. */
+    /** The number of records to return in each page of results.
+     *
+     *  **Note:** If the API is not returning your data, try lowering the page_limit value.
+     */
     pageLimit?: number;
     /** A token identifying the page of results to retrieve. */
     cursor?: string;
@@ -5800,7 +5805,7 @@ namespace AssistantV1 {
     location?: number[];
     /** The entity value that was recognized in the user input. */
     value: string;
-    /** A decimal percentage that represents Watson's confidence in the recognized entity. */
+    /** A decimal percentage that represents confidence in the recognized entity. */
     confidence?: number;
     /** The recognized capture groups for the entity, as defined by the entity pattern. */
     groups?: CaptureGroup[];
@@ -5828,7 +5833,7 @@ namespace AssistantV1 {
   export interface RuntimeEntityAlternative {
     /** The entity value that was recognized in the user input. */
     value?: string;
-    /** A decimal percentage that represents Watson's confidence in the recognized entity. */
+    /** A decimal percentage that represents confidence in the recognized entity. */
     confidence?: number;
   }
 
@@ -5961,8 +5966,8 @@ namespace AssistantV1 {
   export interface RuntimeIntent {
     /** The name of the recognized intent. */
     intent: string;
-    /** A decimal percentage that represents Watson's confidence in the intent. If you are specifying an intent as
-     *  part of a request, but you do not have a calculated confidence value, specify `1`.
+    /** A decimal percentage that represents confidence in the intent. If you are specifying an intent as part of a
+     *  request, but you do not have a calculated confidence value, specify `1`.
      */
     confidence?: number;
   }

discovery/v1.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2024.
+ * (C) Copyright IBM Corp. 2018, 2024.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -6709,9 +6709,9 @@ namespace DiscoveryV1 {
     selector_tags?: string[];
     /** Defines the annotated smart document understanding fields that the document is split on. The content of the
      *  annotated field that the segmentation splits at is used as the **title** field for that segmented result. For
-     *  example, if the field `sub-title` is specified, when a document is uploaded each time the smart documement
+     *  example, if the field `sub-title` is specified, when a document is uploaded each time the smart document
      *  understanding conversion encounters a field of type `sub-title` the document is split at that point and the
-     *  content of the field used as the title of the remaining content. Thnis split is performed for all instances of
+     *  content of the field used as the title of the remaining content. This split is performed for all instances of
      *  the listed fields in the uploaded document. Only valid if used with a collection that has **enabled** set to
      *  `true` in the **smart_document_understanding** object.
      */

language-translator/v3.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2024.
+ * (C) Copyright IBM Corp. 2018, 2024.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,6 +30,12 @@ import {
 import { getSdkHeaders } from '../lib/common';
 
 /**
+ * IBM® is announcing the deprecation of the Watson® Language Translator service for IBM Cloud® in all
+ * regions. As of 10 June 2023, the Language Translator tile will be removed from the IBM Cloud Platform for new
+ * customers; only existing customers will be able to access the product. As of 10 June 2024, the service will reach its
+ * End of Support date. As of 10 December 2024, the service will be withdrawn entirely and will no longer be available
+ * to any customers.{: deprecated}
+ *
  * IBM Watson™ Language Translator translates text from one language to another. The service offers multiple
  * IBM-provided translation models that you can customize based on your unique terminology and language. Use Language
  * Translator to take news from across the globe and present it in your language, communicate with your customers in

natural-language-understanding/v1.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2024.
+ * (C) Copyright IBM Corp. 2017, 2024.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -38,7 +38,7 @@ import { getSdkHeaders } from '../lib/common';
  * models](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-customizing)
  * with Watson Knowledge Studio to detect custom entities and relations in Natural Language Understanding.
  *
- * IBM is sunsetting Watson Natural Language Understanding Custom Sentiment (BETA). From **June 1, 2023** onward, you
+ * IBM is sunsetting Watson Natural Language Understanding Custom Sentiment (BETA). From **June 3, 2023** onward, you
  * will no longer be able to use the Custom Sentiment feature.<br /><br />To ensure we continue providing our clients
  * with robust and powerful text classification capabilities, IBM recently announced the general availability of a new
  * [single-label text classification
@@ -1516,7 +1516,7 @@ namespace NaturalLanguageUnderstandingV1 {
     sadness?: number;
   }
 
-  /** Identifies people, cities, organizations, and other entities in the content. For more information, see [Entity types and subtypes](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-entity-types). Supported languages: English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Swedish. Arabic, Chinese, and Dutch are supported only through custom models. */
+  /** Identifies people, cities, organizations, and other entities in the content. For more information, see [Entity types and subtypes](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-entity-type-systems). Supported languages: English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Swedish. Arabic, Chinese, and Dutch are supported only through custom models. */
   export interface EntitiesOptions {
     /** Maximum number of entities to return. */
     limit?: number;
@@ -1596,7 +1596,7 @@ namespace NaturalLanguageUnderstandingV1 {
     emotion?: EmotionOptions;
     /** Identifies people, cities, organizations, and other entities in the content. For more information, see
      *  [Entity types and
-     *  subtypes](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-entity-types).
+     *  subtypes](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-entity-type-systems).
      *
      *  Supported languages: English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Swedish.
      *  Arabic, Chinese, and Dutch are supported only through custom models.