ibm_watson 2.1.2 → 2.1.3

data/lib/ibm_watson/language_translator_v3.rb

@@ -14,7 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # IBM Watson™ Language Translator translates text from one language to another.
 # The service offers multiple IBM-provided translation models that you can customize based

data/lib/ibm_watson/natural_language_classifier_v1.rb

@@ -14,18 +14,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
-# IBM Watson™ Natural Language Classifier is discontinued. On 9 August 2021, IBM announced the deprecation of
-# the Natural Language Classifier service. The service will no longer be available from 8 August 2022.
-# As of 9 September 2021, you will not be able to create new instances. Existing instances will be supported until
-# 8 August 2022. Any instance that still exists on that date will be deleted.
+# On 9 August 2021, IBM announced the deprecation of IBM Watson™ Natural Language
+# Classifier. As of 9 September 2021, you cannot create new instances. However, existing
+# instances are supported until 8 August 2022. The service will no longer be available on
+# 8 August 2022.<br/><br/>As an alternative, consider migrating to IBM Watson Natural
+# Language Understanding. For more information, see [Migrating to Natural Language
+# Understanding](https://cloud.ibm.com/docs/natural-language-classifier?topic=natural-language-classifier-migrating).
 # {: deprecated}
 #
-# Natural Language Classifier uses machine learning algorithms to
-# return the top matching predefined classes for short text input. You create and train a
-# classifier to connect predefined classes to example texts so that the service can apply
-# those classes to new inputs.
+# Natural Language Classifier uses machine learning algorithms to return the top matching
+# predefined classes for short text input. You create and train a classifier to connect
+# predefined classes to example texts so that the service can apply those classes to new
+# inputs.
 
 require "concurrent"
 require "erb"

data/lib/ibm_watson/natural_language_understanding_v1.rb

@@ -14,7 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # Analyze various features of text content at scale. Provide text, raw HTML, or a public
 # URL and IBM Watson Natural Language Understanding will give you results for the features
@@ -46,7 +46,7 @@ module IBMWatson
     #
     # @param args [Hash] The args to initialize with
     # @option args version [String] Release date of the API version you want to use. Specify dates in YYYY-MM-DD
-    #   format. The current version is `2021-03-25`.
+    #   format. The current version is `2021-08-01`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
@@ -684,9 +684,9 @@ module IBMWatson
     ##
     # @!method create_classifications_model(language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
     # Create classifications model.
-    # (Beta) Creates a custom classifications model by uploading training data and
-    #   associated metadata. The model begins the training and deploying process and is
-    #   ready to use when the `status` is `available`.
+    # Creates a custom classifications model by uploading training data and associated
+    #   metadata. The model begins the training and deploying process and is ready to use
+    #   when the `status` is `available`.
     # @param language [String] The 2-letter language code of this model.
     # @param training_data [File] Training data in JSON format. For more information, see [Classifications training
     #   data
@@ -750,8 +750,7 @@ module IBMWatson
     ##
     # @!method list_classifications_models
     # List classifications models.
-    # (Beta) Returns all custom classifications models associated with this service
-    #   instance.
+    # Returns all custom classifications models associated with this service instance.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_classifications_models
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -780,7 +779,7 @@ module IBMWatson
     ##
     # @!method get_classifications_model(model_id:)
     # Get classifications model details.
-    # (Beta) Returns the status of the classifications model with the given model ID.
+    # Returns the status of the classifications model with the given model ID.
     # @param model_id [String] ID of the model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_classifications_model(model_id:)
@@ -812,8 +811,8 @@ module IBMWatson
     ##
     # @!method update_classifications_model(model_id:, language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
     # Update classifications model.
-    # (Beta) Overwrites the training data associated with this custom classifications
-    #   model and retrains the model. The new model replaces the current deployment.
+    # Overwrites the training data associated with this custom classifications model and
+    #   retrains the model. The new model replaces the current deployment.
     # @param model_id [String] ID of the model.
     # @param language [String] The 2-letter language code of this model.
     # @param training_data [File] Training data in JSON format. For more information, see [Classifications training
@@ -880,9 +879,8 @@ module IBMWatson
     ##
     # @!method delete_classifications_model(model_id:)
     # Delete classifications model.
-    # (Beta) Un-deploys the custom classifications model with the given model ID and
-    #   deletes all associated customer data, including any training data or binary
-    #   artifacts.
+    # Un-deploys the custom classifications model with the given model ID and deletes
+    #   all associated customer data, including any training data or binary artifacts.
     # @param model_id [String] ID of the model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def delete_classifications_model(model_id:)

data/lib/ibm_watson/personality_insights_v3.rb

@@ -14,7 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # IBM Watson™ Personality Insights is discontinued. Existing instances are
 # supported until 1 December 2021, but as of 1 December 2020, you cannot create new

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -14,7 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # The IBM Watson™ Speech to Text service provides APIs that use IBM's
 # speech-recognition capabilities to produce transcripts of spoken audio. The service can
@@ -23,12 +23,11 @@
 # of the audio. It returns all JSON response content in the UTF-8 character set.
 #
 # The service supports two types of models: previous-generation models that include the
-# terms `Broadband` and `Narrowband` in their names, and beta next-generation models that
+# terms `Broadband` and `Narrowband` in their names, and next-generation models that
 # include the terms `Multimedia` and `Telephony` in their names. Broadband and multimedia
 # models have minimum sampling rates of 16 kHz. Narrowband and telephony models have
-# minimum sampling rates of 8 kHz. The beta next-generation models currently support fewer
-# languages and features, but they offer high throughput and greater transcription
-# accuracy.
+# minimum sampling rates of 8 kHz. The next-generation models offer high throughput and
+# greater transcription accuracy.
 #
 # For speech recognition, the service supports synchronous and asynchronous HTTP
 # Representational State Transfer (REST) interfaces. It also supports a WebSocket
@@ -43,10 +42,10 @@
 # is a formal language specification that lets you restrict the phrases that the service
 # can recognize.
 #
-# Language model customization and acoustic model customization are generally available
-# for production use with all previous-generation models that are generally available.
-# Grammars are beta functionality for all previous-generation models that support language
-# model customization. Next-generation models do not support customization at this time.
+# Language model customization is available for most previous- and next-generation models.
+# Acoustic model customization is available for all previous-generation models. Grammars
+# are beta functionality that is available for all previous-generation models that support
+# language model customization.
 
 require "concurrent"
 require "erb"
@@ -125,9 +124,9 @@ module IBMWatson
     #
     #   **See also:** [Listing
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-list).
-    # @param model_id [String] The identifier of the model in the form of its name from the output of the **Get a
-    #   model** method. (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
-    #   `ar-MS_BroadbandModel` instead.).
+    # @param model_id [String] The identifier of the model in the form of its name from the output of the [List
+    #   models](#listmodels) method. (**Note:** The model `ar-AR_BroadbandModel` is
+    #   deprecated; use `ar-MS_BroadbandModel` instead.).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_model(model_id:)
       raise ArgumentError.new("model_id must be provided") if model_id.nil?
@@ -225,31 +224,22 @@ module IBMWatson
     #
     #   ### Next-generation models
     #
-    #    **Note:** The next-generation language models are beta functionality. They
-    #   support a limited number of languages and features at this time. The supported
-    #   languages, models, and features will increase with future releases.
-    #
-    #   The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8 kHz)
-    #   models for many languages. Next-generation models have higher throughput than the
-    #   service's previous generation of `Broadband` and `Narrowband` models. When you use
-    #   next-generation models, the service can return transcriptions more quickly and
+    #    The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8
+    #   kHz) models for many languages. Next-generation models have higher throughput than
+    #   the service's previous generation of `Broadband` and `Narrowband` models. When you
+    #   use next-generation models, the service can return transcriptions more quickly and
     #   also provide noticeably better transcription accuracy.
     #
     #   You specify a next-generation model by using the `model` query parameter, as you
-    #   do a previous-generation model. Next-generation models support the same request
-    #   headers as previous-generation models, but they support only the following
-    #   additional query parameters:
-    #   * `background_audio_suppression`
-    #   * `inactivity_timeout`
-    #   * `profanity_filter`
-    #   * `redaction`
-    #   * `smart_formatting`
-    #   * `speaker_labels`
-    #   * `speech_detector_sensitivity`
-    #   * `timestamps`
-    #
-    #   Many next-generation models also support the beta `low_latency` parameter, which
-    #   is not available with previous-generation models.
+    #   do a previous-generation model. Many next-generation models also support the
+    #   `low_latency` parameter, which is not available with previous-generation models.
+    #
+    #   But next-generation models do not support all of the parameters that are available
+    #   for use with previous-generation models. For more information about all parameters
+    #   that are supported for use with next-generation models, see [Supported features
+    #   for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-features).
+    #
     #
     #   **See also:** [Next-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
@@ -277,7 +267,7 @@ module IBMWatson
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request.
     #   (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
-    #   `ar-MS_BroadbandModel` instead.) See [Languages and
+    #   `ar-MS_BroadbandModel` instead.) See [Previous-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models) and
     #   [Next-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
@@ -374,7 +364,8 @@ module IBMWatson
     #   the service also converts certain keyword strings to punctuation symbols. By
     #   default, the service performs no smart formatting.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Spanish transcription only.
     #
     #   See [Smart
     #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#smart-formatting).
@@ -383,11 +374,13 @@ module IBMWatson
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
-    #   * For previous-generation models, can be used for US English, Australian English,
-    #   German, Japanese, Korean, and Spanish (both broadband and narrowband models) and
-    #   UK English (narrowband model) transcription only.
-    #   * For next-generation models, can be used for English (Australian, UK, and US),
-    #   German, and Spanish transcription only.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #   * For previous-generation models, the parameter can be used for Australian
+    #   English, US English, German, Japanese, Korean, and Spanish (both broadband and
+    #   narrowband models) and UK English (narrowband model) transcription only.
+    #   * For next-generation models, the parameter can be used for English (Australian,
+    #   Indian, UK, and US), German, Japanese, Korean, and Spanish transcription only.
     #
     #   Restrictions and limitations apply to the use of speaker labels for both types of
     #   models. See [Speaker
@@ -399,8 +392,11 @@ module IBMWatson
     #   specify a grammar, you must also use the `language_customization_id` parameter to
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
-    #   it does not recognize other custom words from the model's words resource. See
-    #   [Using a grammar for speech
+    #   it does not recognize other custom words from the model's words resource.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #
+    #   See [Using a grammar for speech
     #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUse).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
@@ -413,7 +409,8 @@ module IBMWatson
     #   `keywords_threshold` parameters) and returns only a single final transcript
     #   (forces the `max_alternatives` parameter to be `1`).
     #
-    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Korean transcription only.
     #
     #   See [Numeric
     #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#numeric-redaction).
@@ -482,14 +479,11 @@ module IBMWatson
     #   produce results even more quickly, though the results might be less accurate when
     #   the parameter is used.
     #
-    #   **Note:** The parameter is beta functionality. It is not available for
-    #   previous-generation `Broadband` and `Narrowband` models. It is available only for
-    #   some next-generation models.
-    #
-    #   * For a list of next-generation models that support low latency, see [Supported
-    #   language
-    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported)
-    #   for next-generation models.
+    #   The parameter is not available for previous-generation `Broadband` and
+    #   `Narrowband` models. It is available only for some next-generation models. For a
+    #   list of next-generation models that support low latency, see [Supported
+    #   next-generation language
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported).
     #   * For more information about the `low_latency` parameter, see [Low
     #   latency](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-interim#low-latency).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -783,9 +777,9 @@ module IBMWatson
     #   The service sends only a single `GET` request to the callback URL. If the service
     #   does not receive a reply with a response code of 200 and a body that echoes the
     #   challenge string sent by the service within five seconds, it does not allowlist
-    #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already allowlisted, the
-    #   service responds to the initial registration request with response code 200.
+    #   the URL; it instead sends status code 400 in response to the request to register a
+    #   callback. If the requested callback URL is already allowlisted, the service
+    #   responds to the initial registration request with response code 200.
     #
     #   If you specify a user secret with the request, the service uses it as a key to
     #   calculate an HMAC-SHA1 signature of the challenge string in its response to the
@@ -840,9 +834,10 @@ module IBMWatson
     ##
     # @!method unregister_callback(callback_url:)
     # Unregister a callback.
-    # Unregisters a callback URL that was previously allowlisted with a **Register a
-    #   callback** request for use with the asynchronous interface. Once unregistered, the
-    #   URL can no longer be used with asynchronous recognition requests.
+    # Unregisters a callback URL that was previously allowlisted with a [Register a
+    #   callback](#registercallback) request for use with the asynchronous interface. Once
+    #   unregistered, the URL can no longer be used with asynchronous recognition
+    #   requests.
     #
     #   **See also:** [Unregistering a callback
     #   URL](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#unregister).
@@ -885,17 +880,17 @@ module IBMWatson
     #   to subscribe to specific events and to specify a string that is to be included
     #   with each notification for the job.
     #   * By polling the service: Omit the `callback_url`, `events`, and `user_token`
-    #   parameters. You must then use the **Check jobs** or **Check a job** methods to
-    #   check the status of the job, using the latter to retrieve the results when the job
-    #   is complete.
+    #   parameters. You must then use the [Check jobs](#checkjobs) or [Check a
+    #   job](#checkjob) methods to check the status of the job, using the latter to
+    #   retrieve the results when the job is complete.
     #
     #   The two approaches are not mutually exclusive. You can poll the service for job
     #   status or obtain results from the service manually even if you include a callback
     #   URL. In both cases, you can include the `results_ttl` parameter to specify how
     #   long the results are to remain available after the job is complete. Using the
-    #   HTTPS **Check a job** method to retrieve results is more secure than receiving
-    #   them via callback notification over HTTP because it provides confidentiality in
-    #   addition to authentication and data integrity.
+    #   HTTPS [Check a job](#checkjob) method to retrieve results is more secure than
+    #   receiving them via callback notification over HTTP because it provides
+    #   confidentiality in addition to authentication and data integrity.
     #
     #   The method supports the same basic parameters as other HTTP and WebSocket
     #   recognition requests. It also supports the following parameters specific to the
@@ -975,31 +970,22 @@ module IBMWatson
     #
     #   ### Next-generation models
     #
-    #    **Note:** The next-generation language models are beta functionality. They
-    #   support a limited number of languages and features at this time. The supported
-    #   languages, models, and features will increase with future releases.
-    #
-    #   The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8 kHz)
-    #   models for many languages. Next-generation models have higher throughput than the
-    #   service's previous generation of `Broadband` and `Narrowband` models. When you use
-    #   next-generation models, the service can return transcriptions more quickly and
+    #    The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8
+    #   kHz) models for many languages. Next-generation models have higher throughput than
+    #   the service's previous generation of `Broadband` and `Narrowband` models. When you
+    #   use next-generation models, the service can return transcriptions more quickly and
     #   also provide noticeably better transcription accuracy.
     #
     #   You specify a next-generation model by using the `model` query parameter, as you
-    #   do a previous-generation model. Next-generation models support the same request
-    #   headers as previous-generation models, but they support only the following
-    #   additional query parameters:
-    #   * `background_audio_suppression`
-    #   * `inactivity_timeout`
-    #   * `profanity_filter`
-    #   * `redaction`
-    #   * `smart_formatting`
-    #   * `speaker_labels`
-    #   * `speech_detector_sensitivity`
-    #   * `timestamps`
-    #
-    #   Many next-generation models also support the beta `low_latency` parameter, which
-    #   is not available with previous-generation models.
+    #   do a previous-generation model. Many next-generation models also support the
+    #   `low_latency` parameter, which is not available with previous-generation models.
+    #
+    #   But next-generation models do not support all of the parameters that are available
+    #   for use with previous-generation models. For more information about all parameters
+    #   that are supported for use with next-generation models, see [Supported features
+    #   for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-features).
+    #
     #
     #   **See also:** [Next-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
@@ -1008,14 +994,14 @@ module IBMWatson
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request.
     #   (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
-    #   `ar-MS_BroadbandModel` instead.) See [Languages and
+    #   `ar-MS_BroadbandModel` instead.) See [Previous-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models) and
     #   [Next-generation languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
-    #   successfully allowlisted by using the **Register a callback** method. You can
-    #   include the same callback URL with any number of job creation requests. Omit the
-    #   parameter to poll the service for job completion and results.
+    #   successfully allowlisted by using the [Register a callback](#registercallback)
+    #   method. You can include the same callback URL with any number of job creation
+    #   requests. Omit the parameter to poll the service for job completion and results.
     #
     #   Use the `user_token` parameter to specify a unique user-specified string with each
     #   job to differentiate the callback notifications for the jobs.
@@ -1024,8 +1010,8 @@ module IBMWatson
     #   * `recognitions.started` generates a callback notification when the service begins
     #   to process the job.
     #   * `recognitions.completed` generates a callback notification when the job is
-    #   complete. You must use the **Check a job** method to retrieve the results before
-    #   they time out or are deleted.
+    #   complete. You must use the [Check a job](#checkjob) method to retrieve the results
+    #   before they time out or are deleted.
     #   * `recognitions.completed_with_results` generates a callback notification when the
     #   job is complete. The notification includes the results of the request.
     #   * `recognitions.failed` generates a callback notification if the service
@@ -1139,7 +1125,8 @@ module IBMWatson
     #   the service also converts certain keyword strings to punctuation symbols. By
     #   default, the service performs no smart formatting.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Spanish transcription only.
     #
     #   See [Smart
     #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#smart-formatting).
@@ -1148,11 +1135,13 @@ module IBMWatson
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
-    #   * For previous-generation models, can be used for US English, Australian English,
-    #   German, Japanese, Korean, and Spanish (both broadband and narrowband models) and
-    #   UK English (narrowband model) transcription only.
-    #   * For next-generation models, can be used for English (Australian, UK, and US),
-    #   German, and Spanish transcription only.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #   * For previous-generation models, the parameter can be used for Australian
+    #   English, US English, German, Japanese, Korean, and Spanish (both broadband and
+    #   narrowband models) and UK English (narrowband model) transcription only.
+    #   * For next-generation models, the parameter can be used for English (Australian,
+    #   Indian, UK, and US), German, Japanese, Korean, and Spanish transcription only.
     #
     #   Restrictions and limitations apply to the use of speaker labels for both types of
     #   models. See [Speaker
@@ -1164,8 +1153,11 @@ module IBMWatson
     #   specify a grammar, you must also use the `language_customization_id` parameter to
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
-    #   it does not recognize other custom words from the model's words resource. See
-    #   [Using a grammar for speech
+    #   it does not recognize other custom words from the model's words resource.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #
+    #   See [Using a grammar for speech
     #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUse).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
@@ -1178,7 +1170,8 @@ module IBMWatson
     #   `keywords_threshold` parameters) and returns only a single final transcript
     #   (forces the `max_alternatives` parameter to be `1`).
     #
-    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Korean transcription only.
     #
     #   See [Numeric
     #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#numeric-redaction).
@@ -1269,14 +1262,11 @@ module IBMWatson
     #   produce results even more quickly, though the results might be less accurate when
     #   the parameter is used.
     #
-    #   **Note:** The parameter is beta functionality. It is not available for
-    #   previous-generation `Broadband` and `Narrowband` models. It is available only for
-    #   some next-generation models.
-    #
-    #   * For a list of next-generation models that support low latency, see [Supported
-    #   language
-    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported)
-    #   for next-generation models.
+    #   The parameter is not available for previous-generation `Broadband` and
+    #   `Narrowband` models. It is available only for some next-generation models. For a
+    #   list of next-generation models that support low latency, see [Supported
+    #   next-generation language
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported).
     #   * For more information about the `low_latency` parameter, see [Low
     #   latency](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-interim#low-latency).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -1345,10 +1335,10 @@ module IBMWatson
     #   credentials with which it is called. The method also returns the creation and
     #   update times of each job, and, if a job was created with a callback URL and a user
     #   token, the user token for the job. To obtain the results for a job whose status is
-    #   `completed` or not one of the latest 100 outstanding jobs, use the **Check a job**
-    #   method. A job and its results remain available until you delete them with the
-    #   **Delete a job** method or until the job's time to live expires, whichever comes
-    #   first.
+    #   `completed` or not one of the latest 100 outstanding jobs, use the [Check a
+    #   job[(#checkjob) method. A job and its results remain available until you delete
+    #   them with the [Delete a job](#deletejob) method or until the job's time to live
+    #   expires, whichever comes first.
     #
     #   **See also:** [Checking the status of the latest
     #   jobs](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#jobs).
@@ -1382,8 +1372,8 @@ module IBMWatson
     #   You can use the method to retrieve the results of any job, regardless of whether
     #   it was submitted with a callback URL and the `recognitions.completed_with_results`
     #   event, and you can retrieve the results multiple times for as long as they remain
-    #   available. Use the **Check jobs** method to request information about the most
-    #   recent jobs associated with the calling credentials.
+    #   available. Use the [Check jobs](#checkjobs) method to request information about
+    #   the most recent jobs associated with the calling credentials.
     #
     #   **See also:** [Checking the status and retrieving the results of a
     #   job](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#job).
@@ -1471,28 +1461,28 @@ module IBMWatson
     #   customizes.
     #
     #   To determine whether a base model supports language model customization, use the
-    #   **Get a model** method and check that the attribute `custom_language_model` is set
-    #   to `true`. You can also refer to [Language support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   [Get a model](#getmodel) method and check that the attribute
+    #   `custom_language_model` is set to `true`. You can also refer to [Language support
+    #   for
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @param dialect [String] The dialect of the specified language that is to be used with the custom language
     #   model. For most languages, the dialect matches the language of the base model by
-    #   default. For example, `en-US` is used for either of the US English language
-    #   models.
+    #   default. For example, `en-US` is used for the US English language models. All
+    #   dialect values are case-insensitive.
     #
-    #   For a Spanish language, the service creates a custom language model that is suited
-    #   for speech in one of the following dialects:
+    #   The parameter is meaningful only for Spanish language models, for which you can
+    #   always safely omit the parameter to have the service create the correct mapping.
+    #   For Spanish, the service creates a custom language model that is suited for speech
+    #   in one of the following dialects:
     #   * `es-ES` for Castilian Spanish (`es-ES` models)
     #   * `es-LA` for Latin American Spanish (`es-AR`, `es-CL`, `es-CO`, and `es-PE`
     #   models)
     #   * `es-US` for Mexican (North American) Spanish (`es-MX` models)
     #
-    #   The parameter is meaningful only for Spanish models, for which you can always
-    #   safely omit the parameter to have the service create the correct mapping.
-    #
-    #   If you specify the `dialect` parameter for non-Spanish language models, its value
-    #   must match the language of the base model. If you specify the `dialect` for
-    #   Spanish language models, its value must match one of the defined mappings as
-    #   indicated (`es-ES`, `es-LA`, or `es-MX`). All dialect values are case-insensitive.
+    #   If you specify the `dialect` parameter for a non-Spanish language model, its value
+    #   must match the language of the base model. If you specify the `dialect` for a
+    #   Spanish language model, its value must match one of the defined mappings (`es-ES`,
+    #   `es-LA`, or `es-MX`).
     # @param description [String] A description of the new custom language model. Use a localized description that
     #   matches the language of the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -1543,7 +1533,7 @@ module IBMWatson
     #
     #   To determine the languages for which customization is available, see [Language
     #   support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -1647,12 +1637,13 @@ module IBMWatson
     #   the current load on the service. The method returns an HTTP 200 response code to
     #   indicate that the training process has begun.
     #
-    #   You can monitor the status of the training by using the **Get a custom language
-    #   model** method to poll the model's status. Use a loop to check the status every 10
-    #   seconds. The method returns a `LanguageModel` object that includes `status` and
-    #   `progress` fields. A status of `available` means that the custom model is trained
-    #   and ready to use. The service cannot accept subsequent training requests or
-    #   requests to add new resources until the existing request completes.
+    #   You can monitor the status of the training by using the [Get a custom language
+    #   model](#getlanguagemodel) method to poll the model's status. Use a loop to check
+    #   the status every 10 seconds. The method returns a `LanguageModel` object that
+    #   includes `status` and `progress` fields. A status of `available` means that the
+    #   custom model is trained and ready to use. The service cannot accept subsequent
+    #   training requests or requests to add new resources until the existing request
+    #   completes.
     #
     #   **See also:** [Train the custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
@@ -1672,14 +1663,18 @@ module IBMWatson
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
-    # @param word_type_to_add [String] The type of words from the custom language model's words resource on which to
-    #   train the model:
+    # @param word_type_to_add [String] _For custom models that are based on previous-generation models_, the type of
+    #   words from the custom language model's words resource on which to train the model:
     #   * `all` (the default) trains the model on all new words, regardless of whether
     #   they were extracted from corpora or grammars or were added or modified by the
     #   user.
-    #   * `user` trains the model only on new words that were added or modified by the
+    #   * `user` trains the model only on custom words that were added or modified by the
     #   user directly. The model is not trained on new words extracted from corpora or
     #   grammars.
+    #
+    #   _For custom models that are based on next-generation models_, the service ignores
+    #   the parameter. The words resource contains only custom words that the user adds or
+    #   modifies directly, so the parameter is unnecessary.
     # @param customization_weight [Float] Specifies a customization weight for the custom language model. The customization
     #   weight tells the service how much weight to give to words from the custom language
     #   model compared to those from the base model for speech recognition. Specify a
@@ -1770,12 +1765,16 @@ module IBMWatson
     #
     #   The method returns an HTTP 200 response code to indicate that the upgrade process
     #   has begun successfully. You can monitor the status of the upgrade by using the
-    #   **Get a custom language model** method to poll the model's status. The method
-    #   returns a `LanguageModel` object that includes `status` and `progress` fields. Use
-    #   a loop to check the status every 10 seconds. While it is being upgraded, the
-    #   custom model has the status `upgrading`. When the upgrade is complete, the model
-    #   resumes the status that it had prior to upgrade. The service cannot accept
-    #   subsequent requests for the model until the upgrade completes.
+    #   [Get a custom language model](#getlanguagemodel) method to poll the model's
+    #   status. The method returns a `LanguageModel` object that includes `status` and
+    #   `progress` fields. Use a loop to check the status every 10 seconds. While it is
+    #   being upgraded, the custom model has the status `upgrading`. When the upgrade is
+    #   complete, the model resumes the status that it had prior to upgrade. The service
+    #   cannot accept subsequent requests for the model until the upgrade completes.
+    #
+    #   **Note:** Upgrading is necessary only for custom language models that are based on
+    #   previous-generation models. Only a single version of a custom model that is based
+    #   on a next-generation model is ever available.
     #
     #   **See also:** [Upgrading a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-language).
@@ -1809,9 +1808,10 @@ module IBMWatson
     # @!method list_corpora(customization_id:)
     # List corpora.
     # Lists information about all corpora from a custom language model. The information
-    #   includes the total number of words and out-of-vocabulary (OOV) words, name, and
-    #   status of each corpus. You must use credentials for the instance of the service
-    #   that owns a model to list its corpora.
+    #   includes the name, status, and total number of words for each corpus. _For custom
+    #   models that are based on previous-generation models_, it also includes the number
+    #   of out-of-vocabulary (OOV) words from the corpus. You must use credentials for the
+    #   instance of the service that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
@@ -1845,51 +1845,60 @@ module IBMWatson
     #   Use multiple requests to submit multiple corpus text files. You must use
     #   credentials for the instance of the service that owns a model to add a corpus to
     #   it. Adding a corpus does not affect the custom language model until you train the
-    #   model for the new data by using the **Train a custom language model** method.
+    #   model for the new data by using the [Train a custom language
+    #   model](#trainlanguagemodel) method.
     #
     #   Submit a plain text file that contains sample sentences from the domain of
-    #   interest to enable the service to extract words in context. The more sentences you
-    #   add that represent the context in which speakers use words from the domain, the
-    #   better the service's recognition accuracy.
+    #   interest to enable the service to parse the words in context. The more sentences
+    #   you add that represent the context in which speakers use words from the domain,
+    #   the better the service's recognition accuracy.
     #
     #   The call returns an HTTP 201 response code if the corpus is valid. The service
-    #   then asynchronously processes the contents of the corpus and automatically
-    #   extracts new words that it finds. This operation can take on the order of minutes
-    #   to complete depending on the total number of words and the number of new words in
-    #   the corpus, as well as the current load on the service. You cannot submit requests
-    #   to add additional resources to the custom model or to train the model until the
-    #   service's analysis of the corpus for the current request completes. Use the **List
-    #   a corpus** method to check the status of the analysis.
-    #
-    #   The service auto-populates the model's words resource with words from the corpus
-    #   that are not found in its base vocabulary. These words are referred to as
-    #   out-of-vocabulary (OOV) words. After adding a corpus, you must validate the words
-    #   resource to ensure that each OOV word's definition is complete and valid. You can
-    #   use the **List custom words** method to examine the words resource. You can use
-    #   other words method to eliminate typos and modify how words are pronounced as
-    #   needed.
+    #   then asynchronously processes and automatically extracts data from the contents of
+    #   the corpus. This operation can take on the order of minutes to complete depending
+    #   on the current load on the service, the total number of words in the corpus, and,
+    #   _for custom models that are based on previous-generation models_, the number of
+    #   new (out-of-vocabulary) words in the corpus. You cannot submit requests to add
+    #   additional resources to the custom model or to train the model until the service's
+    #   analysis of the corpus for the current request completes. Use the [Get a
+    #   corpus](#getcorpus) method to check the status of the analysis.
+    #
+    #   _For custom models that are based on previous-generation models_, the service
+    #   auto-populates the model's words resource with words from the corpus that are not
+    #   found in its base vocabulary. These words are referred to as out-of-vocabulary
+    #   (OOV) words. After adding a corpus, you must validate the words resource to ensure
+    #   that each OOV word's definition is complete and valid. You can use the [List
+    #   custom words](#listwords) method to examine the words resource. You can use other
+    #   words method to eliminate typos and modify how words are pronounced as needed.
     #
     #   To add a corpus file that has the same name as an existing corpus, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
     #   an existing corpus causes the service to process the corpus text file and extract
-    #   OOV words anew. Before doing so, it removes any OOV words associated with the
-    #   existing corpus from the model's words resource unless they were also added by
-    #   another corpus or grammar, or they have been modified in some way with the **Add
-    #   custom words** or **Add a custom word** method.
+    #   its data anew. _For a custom model that is based on a previous-generation model_,
+    #   the service first removes any OOV words that are associated with the existing
+    #   corpus from the model's words resource unless they were also added by another
+    #   corpus or grammar, or they have been modified in some way with the [Add custom
+    #   words](#addwords) or [Add a custom word](#addword) method.
     #
     #   The service limits the overall amount of data that you can add to a custom model
-    #   to a maximum of 10 million total words from all sources combined. Also, you can
-    #   add no more than 90 thousand custom (OOV) words to a model. This includes words
-    #   that the service extracts from corpora and grammars, and words that you add
-    #   directly.
+    #   to a maximum of 10 million total words from all sources combined. _For a custom
+    #   model that is based on a previous-generation model_, you can add no more than 90
+    #   thousand custom (OOV) words to a model. This includes words that the service
+    #   extracts from corpora and grammars, and words that you add directly.
     #
     #   **See also:**
     #   * [Add a corpus to the custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addCorpus)
-    #   * [Working with
-    #   corpora](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
-    #   * [Validating a words
-    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
+    #   * [Working with corpora for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
+    #   * [Working with corpora for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingCorpora-ng)
+    #
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -1912,10 +1921,10 @@ module IBMWatson
     #   in UTF-8 if it contains non-ASCII characters; the service assumes UTF-8 encoding
     #   if it encounters non-ASCII characters.
     #
-    #   Make sure that you know the character encoding of the file. You must use that
+    #   Make sure that you know the character encoding of the file. You must use that same
     #   encoding when working with the words in the custom language model. For more
-    #   information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   information, see [Character encoding for custom
+    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#charEncoding).
     #
     #
     #   With the `curl` command, use the `--data-binary` option to upload the file for the
@@ -1964,9 +1973,10 @@ module IBMWatson
     # @!method get_corpus(customization_id:, corpus_name:)
     # Get a corpus.
     # Gets information about a corpus from a custom language model. The information
-    #   includes the total number of words and out-of-vocabulary (OOV) words, name, and
-    #   status of the corpus. You must use credentials for the instance of the service
-    #   that owns a model to list its corpora.
+    #   includes the name, status, and total number of words for the corpus. _For custom
+    #   models that are based on previous-generation models_, it also includes the number
+    #   of out-of-vocabulary (OOV) words from the corpus. You must use credentials for the
+    #   instance of the service that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
@@ -1999,14 +2009,18 @@ module IBMWatson
     ##
     # @!method delete_corpus(customization_id:, corpus_name:)
     # Delete a corpus.
-    # Deletes an existing corpus from a custom language model. The service removes any
-    #   out-of-vocabulary (OOV) words that are associated with the corpus from the custom
-    #   model's words resource unless they were also added by another corpus or grammar,
-    #   or they were modified in some way with the **Add custom words** or **Add a custom
-    #   word** method. Removing a corpus does not affect the custom model until you train
-    #   the model with the **Train a custom language model** method. You must use
-    #   credentials for the instance of the service that owns a model to delete its
-    #   corpora.
+    # Deletes an existing corpus from a custom language model. Removing a corpus does
+    #   not affect the custom model until you train the model with the [Train a custom
+    #   language model](#trainlanguagemodel) method. You must use credentials for the
+    #   instance of the service that owns a model to delete its corpora.
+    #
+    #   _For custom models that are based on previous-generation models_, the service
+    #   removes any out-of-vocabulary (OOV) words that are associated with the corpus from
+    #   the custom model's words resource unless they were also added by another corpus or
+    #   grammar, or they were modified in some way with the [Add custom words](#addwords)
+    #   or [Add a custom word](#addword) method.
+    #
+    #
     #
     #   **See also:** [Deleting a corpus from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#deleteCorpus).
@@ -2044,10 +2058,11 @@ module IBMWatson
     # List custom words.
     # Lists information about custom words from a custom language model. You can list
     #   all words from the custom model's words resource, only custom words that were
-    #   added or modified by the user, or only out-of-vocabulary (OOV) words that were
-    #   extracted from corpora or are recognized by grammars. You can also indicate the
-    #   order in which the service is to return words; by default, the service lists words
-    #   in ascending alphabetical order. You must use credentials for the instance of the
+    #   added or modified by the user, or, _for a custom model that is based on a
+    #   previous-generation model_, only out-of-vocabulary (OOV) words that were extracted
+    #   from corpora or are recognized by grammars. You can also indicate the order in
+    #   which the service is to return words; by default, the service lists words in
+    #   ascending alphabetical order. You must use credentials for the instance of the
     #   service that owns a model to list information about its words.
     #
     #   **See also:** [Listing words from a custom language
@@ -2060,6 +2075,10 @@ module IBMWatson
     #   * `user` shows only custom words that were added or modified by the user directly.
     #   * `corpora` shows only OOV that were extracted from corpora.
     #   * `grammars` shows only OOV words that are recognized by grammars.
+    #
+    #   _For a custom model that is based on a next-generation model_, only `all` and
+    #   `user` apply. Both options return the same results. Words from other sources are
+    #   not added to custom models that are based on next-generation models.
     # @param sort [String] Indicates the order in which the words are to be listed, `alphabetical` or by
     #   `count`. You can prepend an optional `+` or `-` to an argument to indicate whether
     #   the results are to be sorted in ascending or descending order. By default, words
@@ -2096,10 +2115,14 @@ module IBMWatson
     ##
     # @!method add_words(customization_id:, words:)
     # Add custom words.
-    # Adds one or more custom words to a custom language model. The service populates
+    # Adds one or more custom words to a custom language model. You can use this method
+    #   to add words or to modify existing words in a custom model's words resource. _For
+    #   custom models that are based on previous-generation models_, the service populates
     #   the words resource for a custom model with out-of-vocabulary (OOV) words from each
-    #   corpus or grammar that is added to the model. You can use this method to add
-    #   additional words or to modify existing words in the words resource. The words
+    #   corpus or grammar that is added to the model. You can use this method to modify
+    #   OOV words in the model's words resource.
+    #
+    #   _For a custom model that is based on a previous-generation model_, the words
     #   resource for a model can contain a maximum of 90 thousand custom (OOV) words. This
     #   includes words that the service extracts from corpora and grammars and words that
     #   you add directly.
@@ -2107,25 +2130,26 @@ module IBMWatson
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify custom words for the model. Adding or modifying custom words does not
     #   affect the custom model until you train the model for the new data by using the
-    #   **Train a custom language model** method.
+    #   [Train a custom language model](#trainlanguagemodel) method.
     #
     #   You add custom words by providing a `CustomWords` object, which is an array of
-    #   `CustomWord` objects, one per word. You must use the object's `word` parameter to
-    #   identify the word that is to be added. You can also provide one or both of the
-    #   optional `sounds_like` and `display_as` fields for each word.
-    #   * The `sounds_like` field provides an array of one or more pronunciations for the
-    #   word. Use the parameter to specify how the word can be pronounced by users. Use
-    #   the parameter for words that are difficult to pronounce, foreign words, acronyms,
-    #   and so on. For example, you might specify that the word `IEEE` can sound like `i
-    #   triple e`. You can specify a maximum of five sounds-like pronunciations for a
-    #   word. If you omit the `sounds_like` field, the service attempts to set the field
-    #   to its pronunciation of the word. It cannot generate a pronunciation for all
-    #   words, so you must review the word's definition to ensure that it is complete and
-    #   valid.
+    #   `CustomWord` objects, one per word. Use the object's `word` parameter to identify
+    #   the word that is to be added. You can also provide one or both of the optional
+    #   `display_as` or `sounds_like` fields for each word.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
     #   usual representation or from its spelling in training data. For example, you might
-    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
+    #   indicate that the word `IBM` is to be displayed as `IBM™`.
+    #   * The `sounds_like` field, _which can be used only with a custom model that is
+    #   based on a previous-generation model_, provides an array of one or more
+    #   pronunciations for the word. Use the parameter to specify how the word can be
+    #   pronounced by users. Use the parameter for words that are difficult to pronounce,
+    #   foreign words, acronyms, and so on. For example, you might specify that the word
+    #   `IEEE` can sound like `i triple e`. You can specify a maximum of five sounds-like
+    #   pronunciations for a word. If you omit the `sounds_like` field, the service
+    #   attempts to set the field to its pronunciation of the word. It cannot generate a
+    #   pronunciation for all words, so you must review the word's definition to ensure
+    #   that it is complete and valid.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
@@ -2137,26 +2161,30 @@ module IBMWatson
     #   time that it takes for the analysis to complete depends on the number of new words
     #   that you add but is generally faster than adding a corpus or grammar.
     #
-    #   You can monitor the status of the request by using the **List a custom language
-    #   model** method to poll the model's status. Use a loop to check the status every 10
-    #   seconds. The method returns a `Customization` object that includes a `status`
-    #   field. A status of `ready` means that the words have been added to the custom
-    #   model. The service cannot accept requests to add new data or to train the model
-    #   until the existing request completes.
-    #
-    #   You can use the **List custom words** or **List a custom word** method to review
-    #   the words that you add. Words with an invalid `sounds_like` field include an
-    #   `error` field that describes the problem. You can use other words-related methods
-    #   to correct errors, eliminate typos, and modify how words are pronounced as needed.
+    #   You can monitor the status of the request by using the [Get a custom language
+    #   model](#getlanguagemodel) method to poll the model's status. Use a loop to check
+    #   the status every 10 seconds. The method returns a `Customization` object that
+    #   includes a `status` field. A status of `ready` means that the words have been
+    #   added to the custom model. The service cannot accept requests to add new data or
+    #   to train the model until the existing request completes.
     #
+    #   You can use the [List custom words](#listwords) or [Get a custom word](#getword)
+    #   method to review the words that you add. Words with an invalid `sounds_like` field
+    #   include an `error` field that describes the problem. You can use other
+    #   words-related methods to correct errors, eliminate typos, and modify how words are
+    #   pronounced as needed.
     #
     #   **See also:**
     #   * [Add words to the custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addWords)
-    #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
-    #   * [Validating a words
-    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
+    #   * [Working with custom words for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Working with custom words for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingWords-ng)
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2192,47 +2220,57 @@ module IBMWatson
     ##
     # @!method add_word(customization_id:, word_name:, word: nil, sounds_like: nil, display_as: nil)
     # Add a custom word.
-    # Adds a custom word to a custom language model. The service populates the words
-    #   resource for a custom model with out-of-vocabulary (OOV) words from each corpus or
-    #   grammar that is added to the model. You can use this method to add a word or to
-    #   modify an existing word in the words resource. The words resource for a model can
-    #   contain a maximum of 90 thousand custom (OOV) words. This includes words that the
-    #   service extracts from corpora and grammars and words that you add directly.
+    # Adds a custom word to a custom language model. You can use this method to add a
+    #   word or to modify an existing word in the words resource. _For custom models that
+    #   are based on previous-generation models_, the service populates the words resource
+    #   for a custom model with out-of-vocabulary (OOV) words from each corpus or grammar
+    #   that is added to the model. You can use this method to modify OOV words in the
+    #   model's words resource.
+    #
+    #   _For a custom model that is based on a previous-generation models_, the words
+    #   resource for a model can contain a maximum of 90 thousand custom (OOV) words. This
+    #   includes words that the service extracts from corpora and grammars and words that
+    #   you add directly.
     #
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify a custom word for the model. Adding or modifying a custom word does not
     #   affect the custom model until you train the model for the new data by using the
-    #   **Train a custom language model** method.
+    #   [Train a custom language model](#trainlanguagemodel) method.
     #
     #   Use the `word_name` parameter to specify the custom word that is to be added or
     #   modified. Use the `CustomWord` object to provide one or both of the optional
-    #   `sounds_like` and `display_as` fields for the word.
-    #   * The `sounds_like` field provides an array of one or more pronunciations for the
-    #   word. Use the parameter to specify how the word can be pronounced by users. Use
-    #   the parameter for words that are difficult to pronounce, foreign words, acronyms,
-    #   and so on. For example, you might specify that the word `IEEE` can sound like `i
-    #   triple e`. You can specify a maximum of five sounds-like pronunciations for a
-    #   word. If you omit the `sounds_like` field, the service attempts to set the field
-    #   to its pronunciation of the word. It cannot generate a pronunciation for all
-    #   words, so you must review the word's definition to ensure that it is complete and
-    #   valid.
+    #   `display_as` or `sounds_like` fields for the word.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
     #   usual representation or from its spelling in training data. For example, you might
-    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
+    #   indicate that the word `IBM` is to be displayed as `IBM™`.
+    #   * The `sounds_like` field, _which can be used only with a custom model that is
+    #   based on a previous-generation model_, provides an array of one or more
+    #   pronunciations for the word. Use the parameter to specify how the word can be
+    #   pronounced by users. Use the parameter for words that are difficult to pronounce,
+    #   foreign words, acronyms, and so on. For example, you might specify that the word
+    #   `IEEE` can sound like `i triple e`. You can specify a maximum of five sounds-like
+    #   pronunciations for a word. If you omit the `sounds_like` field, the service
+    #   attempts to set the field to its pronunciation of the word. It cannot generate a
+    #   pronunciation for all words, so you must review the word's definition to ensure
+    #   that it is complete and valid.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
     #   service encounters an error, it does not add the word to the words resource. Use
-    #   the **List a custom word** method to review the word that you add.
+    #   the [Get a custom word](#getword) method to review the word that you add.
     #
     #   **See also:**
     #   * [Add words to the custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addWords)
-    #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
-    #   * [Validating a words
-    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
+    #   * [Working with custom words for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Working with custom words for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingWords-ng)
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2241,14 +2279,16 @@ module IBMWatson
     #   the tokens of compound words. URL-encode the word if it includes non-ASCII
     #   characters. For more information, see [Character
     #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
-    # @param word [String] For the **Add custom words** method, you must specify the custom word that is to
-    #   be added to or updated in the custom model. Do not include spaces in the word. Use
-    #   a `-` (dash) or `_` (underscore) to connect the tokens of compound words.
-    #
-    #   Omit this parameter for the **Add a custom word** method.
-    # @param sounds_like [Array[String]] An array of sounds-like pronunciations for the custom word. Specify how words that
-    #   are difficult to pronounce, foreign words, acronyms, and so on can be pronounced
-    #   by users.
+    # @param word [String] For the [Add custom words](#addwords) method, you must specify the custom word
+    #   that is to be added to or updated in the custom model. Do not include spaces in
+    #   the word. Use a `-` (dash) or `_` (underscore) to connect the tokens of compound
+    #   words.
+    #
+    #   Omit this parameter for the [Add a custom word](#addword) method.
+    # @param sounds_like [Array[String]] _For a custom model that is based on a previous-generation model_, an array of
+    #   sounds-like pronunciations for the custom word. Specify how words that are
+    #   difficult to pronounce, foreign words, acronyms, and so on can be pronounced by
+    #   users.
     #   * For a word that is not in the service's base vocabulary, omit the parameter to
     #   have the service automatically generate a sounds-like pronunciation for the word.
     #   * For a word that is in the service's base vocabulary, use the parameter to
@@ -2258,6 +2298,10 @@ module IBMWatson
     #
     #   A word can have at most five sounds-like pronunciations. A pronunciation can
     #   include at most 40 characters not including spaces.
+    #
+    #   _For a custom model that is based on a next-generation model_, omit this field.
+    #   Custom models based on next-generation models do not support the `sounds_like`
+    #   field. The service ignores the field.
     # @param display_as [String] An alternative spelling for the custom word when it appears in a transcript. Use
     #   the parameter when you want the word to have a spelling that is different from its
     #   usual representation or from its spelling in corpora training data.
@@ -2332,11 +2376,12 @@ module IBMWatson
     # Delete a custom word.
     # Deletes a custom word from a custom language model. You can remove any word that
     #   you added to the custom model's words resource via any means. However, if the word
-    #   also exists in the service's base vocabulary, the service removes only the custom
-    #   pronunciation for the word; the word remains in the base vocabulary. Removing a
+    #   also exists in the service's base vocabulary, the service removes the word only
+    #   from the words resource; the word remains in the base vocabulary. Removing a
     #   custom word does not affect the custom model until you train the model with the
-    #   **Train a custom language model** method. You must use credentials for the
-    #   instance of the service that owns a model to delete its words.
+    #   [Train a custom language model](#trainlanguagemodel) method. You must use
+    #   credentials for the instance of the service that owns a model to delete its words.
+    #
     #
     #   **See also:** [Deleting a word from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#deleteWord).
@@ -2377,7 +2422,11 @@ module IBMWatson
     # Lists information about all grammars from a custom language model. The information
     #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
     #   each grammar. You must use credentials for the instance of the service that owns a
-    #   model to list its grammars.
+    #   model to list its grammars. Grammars are available for all languages and models
+    #   that support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Listing grammars from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
@@ -2411,8 +2460,8 @@ module IBMWatson
     #   UTF-8 format that defines the grammar. Use multiple requests to submit multiple
     #   grammar files. You must use credentials for the instance of the service that owns
     #   a model to add a grammar to it. Adding a grammar does not affect the custom
-    #   language model until you train the model for the new data by using the **Train a
-    #   custom language model** method.
+    #   language model until you train the model for the new data by using the [Train a
+    #   custom language model](#trainlanguagemodel) method.
     #
     #   The call returns an HTTP 201 response code if the grammar is valid. The service
     #   then asynchronously processes the contents of the grammar and automatically
@@ -2420,27 +2469,33 @@ module IBMWatson
     #   to complete depending on the size and complexity of the grammar, as well as the
     #   current load on the service. You cannot submit requests to add additional
     #   resources to the custom model or to train the model until the service's analysis
-    #   of the grammar for the current request completes. Use the **Get a grammar** method
-    #   to check the status of the analysis.
+    #   of the grammar for the current request completes. Use the [Get a
+    #   grammar](#getgrammar) method to check the status of the analysis.
     #
     #   The service populates the model's words resource with any word that is recognized
     #   by the grammar that is not found in the model's base vocabulary. These are
-    #   referred to as out-of-vocabulary (OOV) words. You can use the **List custom
-    #   words** method to examine the words resource and use other words-related methods
-    #   to eliminate typos and modify how words are pronounced as needed.
+    #   referred to as out-of-vocabulary (OOV) words. You can use the [List custom
+    #   words](#listwords) method to examine the words resource and use other
+    #   words-related methods to eliminate typos and modify how words are pronounced as
+    #   needed.
     #
     #   To add a grammar that has the same name as an existing grammar, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
     #   an existing grammar causes the service to process the grammar file and extract OOV
     #   words anew. Before doing so, it removes any OOV words associated with the existing
     #   grammar from the model's words resource unless they were also added by another
-    #   resource or they have been modified in some way with the **Add custom words** or
-    #   **Add a custom word** method.
+    #   resource or they have been modified in some way with the [Add custom
+    #   words](#addwords) or [Add a custom word](#addword) method.
     #
     #   The service limits the overall amount of data that you can add to a custom model
     #   to a maximum of 10 million total words from all sources combined. Also, you can
     #   add no more than 90 thousand OOV words to a model. This includes words that the
     #   service extracts from corpora and grammars and words that you add directly.
+    #   Grammars are available for all languages and models that support language
+    #   customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:**
     #   * [Understanding
@@ -2523,7 +2578,11 @@ module IBMWatson
     # Gets information about a grammar from a custom language model. The information
     #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
     #   the grammar. You must use credentials for the instance of the service that owns a
-    #   model to list its grammars.
+    #   model to list its grammars. Grammars are available for all languages and models
+    #   that support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Listing grammars from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
@@ -2559,10 +2618,15 @@ module IBMWatson
     # Deletes an existing grammar from a custom language model. The service removes any
     #   out-of-vocabulary (OOV) words associated with the grammar from the custom model's
     #   words resource unless they were also added by another resource or they were
-    #   modified in some way with the **Add custom words** or **Add a custom word**
-    #   method. Removing a grammar does not affect the custom model until you train the
-    #   model with the **Train a custom language model** method. You must use credentials
-    #   for the instance of the service that owns a model to delete its grammar.
+    #   modified in some way with the [Add custom words](#addwords) or [Add a custom
+    #   word](#addword) method. Removing a grammar does not affect the custom model until
+    #   you train the model with the [Train a custom language model](#trainlanguagemodel)
+    #   method. You must use credentials for the instance of the service that owns a model
+    #   to delete its grammar. Grammars are available for all languages and models that
+    #   support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Deleting a grammar from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
@@ -2608,6 +2672,9 @@ module IBMWatson
     #   do not lose any models, but you cannot create any more until your model count is
     #   below the limit.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Create a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#createModel-acoustic).
     # @param name [String] A user-defined name for the new custom acoustic model. Use a name that is unique
@@ -2622,7 +2689,7 @@ module IBMWatson
     #
     #   To determine whether a base model supports acoustic model customization, refer to
     #   [Language support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @param description [String] A description of the new custom acoustic model. Use a localized description that
     #   matches the language of the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -2663,6 +2730,9 @@ module IBMWatson
     #   all languages. You must use credentials for the instance of the service that owns
     #   a model to list information about it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing custom acoustic
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
@@ -2672,7 +2742,7 @@ module IBMWatson
     #
     #   To determine the languages for which customization is available, see [Language
     #   support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -2702,6 +2772,9 @@ module IBMWatson
     # Gets information about a specified custom acoustic model. You must use credentials
     #   for the instance of the service that owns a model to list information about it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing custom acoustic
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -2735,6 +2808,9 @@ module IBMWatson
     #   processed. You must use credentials for the instance of the service that owns a
     #   model to delete it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Deleting a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#deleteModel-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -2779,14 +2855,14 @@ module IBMWatson
     #   audio. The method returns an HTTP 200 response code to indicate that the training
     #   process has begun.
     #
-    #   You can monitor the status of the training by using the **Get a custom acoustic
-    #   model** method to poll the model's status. Use a loop to check the status once a
-    #   minute. The method returns an `AcousticModel` object that includes `status` and
-    #   `progress` fields. A status of `available` indicates that the custom model is
-    #   trained and ready to use. The service cannot train a model while it is handling
-    #   another request for the model. The service cannot accept subsequent training
-    #   requests, or requests to add new audio resources, until the existing training
-    #   request completes.
+    #   You can monitor the status of the training by using the [Get a custom acoustic
+    #   model](#getacousticmodel) method to poll the model's status. Use a loop to check
+    #   the status once a minute. The method returns an `AcousticModel` object that
+    #   includes `status` and `progress` fields. A status of `available` indicates that
+    #   the custom model is trained and ready to use. The service cannot train a model
+    #   while it is handling another request for the model. The service cannot accept
+    #   subsequent training requests, or requests to add new audio resources, until the
+    #   existing training request completes.
     #
     #   You can use the optional `custom_language_model_id` parameter to specify the GUID
     #   of a separately created custom language model that is to be used during training.
@@ -2797,6 +2873,9 @@ module IBMWatson
     #   same version of the same base model, and the custom language model must be fully
     #   trained and available.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:**
     #   * [Train the custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#trainModel-acoustic)
@@ -2868,6 +2947,9 @@ module IBMWatson
     #   request completes. You must use credentials for the instance of the service that
     #   owns a model to reset it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Resetting a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#resetModel-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -2906,14 +2988,14 @@ module IBMWatson
     #
     #   The method returns an HTTP 200 response code to indicate that the upgrade process
     #   has begun successfully. You can monitor the status of the upgrade by using the
-    #   **Get a custom acoustic model** method to poll the model's status. The method
-    #   returns an `AcousticModel` object that includes `status` and `progress` fields.
-    #   Use a loop to check the status once a minute. While it is being upgraded, the
-    #   custom model has the status `upgrading`. When the upgrade is complete, the model
-    #   resumes the status that it had prior to upgrade. The service cannot upgrade a
-    #   model while it is handling another request for the model. The service cannot
-    #   accept subsequent requests for the model until the existing upgrade request
-    #   completes.
+    #   [Get a custom acoustic model](#getacousticmodel) method to poll the model's
+    #   status. The method returns an `AcousticModel` object that includes `status` and
+    #   `progress` fields. Use a loop to check the status once a minute. While it is being
+    #   upgraded, the custom model has the status `upgrading`. When the upgrade is
+    #   complete, the model resumes the status that it had prior to upgrade. The service
+    #   cannot upgrade a model while it is handling another request for the model. The
+    #   service cannot accept subsequent requests for the model until the existing upgrade
+    #   request completes.
     #
     #   If the custom acoustic model was trained with a separately created custom language
     #   model, you must use the `custom_language_model_id` parameter to specify the GUID
@@ -2921,6 +3003,9 @@ module IBMWatson
     #   the custom acoustic model can be upgraded. Omit the parameter if the custom
     #   acoustic model was not trained with a custom language model.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Upgrading a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -2976,6 +3061,9 @@ module IBMWatson
     #   to a request to add it to the custom acoustic model. You must use credentials for
     #   the instance of the service that owns a model to list its audio resources.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing audio resources for a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -3008,8 +3096,8 @@ module IBMWatson
     #   the acoustic characteristics of the audio that you plan to transcribe. You must
     #   use credentials for the instance of the service that owns a model to add an audio
     #   resource to it. Adding audio data does not affect the custom acoustic model until
-    #   you train the model for the new data by using the **Train a custom acoustic
-    #   model** method.
+    #   you train the model for the new data by using the [Train a custom acoustic
+    #   model](#trainacousticmodel) method.
     #
     #   You can add individual audio files or an archive file that contains multiple audio
     #   files. Adding multiple audio files via a single archive file is significantly more
@@ -3034,11 +3122,14 @@ module IBMWatson
     #   upgrade the model until the service's analysis of all audio resources for current
     #   requests completes.
     #
-    #   To determine the status of the service's analysis of the audio, use the **Get an
-    #   audio resource** method to poll the status of the audio. The method accepts the
-    #   customization ID of the custom model and the name of the audio resource, and it
-    #   returns the status of the resource. Use a loop to check the status of the audio
-    #   every few seconds until it becomes `ok`.
+    #   To determine the status of the service's analysis of the audio, use the [Get an
+    #   audio resource](#getaudio) method to poll the status of the audio. The method
+    #   accepts the customization ID of the custom model and the name of the audio
+    #   resource, and it returns the status of the resource. Use a loop to check the
+    #   status of the audio every few seconds until it becomes `ok`.
+    #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
     #
     #   **See also:** [Add audio to the custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#addAudio).
@@ -3133,7 +3224,7 @@ module IBMWatson
     #   For an archive-type resource, the media type of the archive file. For more
     #   information, see **Content types for archive-type resources** in the method
     #   description.
-    # @param contained_content_type [String] **For an archive-type resource,** specify the format of the audio files that are
+    # @param contained_content_type [String] _For an archive-type resource_, specify the format of the audio files that are
     #   contained in the archive file if they are of type `audio/alaw`, `audio/basic`,
     #   `audio/l16`, or `audio/mulaw`. Include the `rate`, `channels`, and `endianness`
     #   parameters where necessary. In this case, all audio files that are contained in
@@ -3147,7 +3238,7 @@ module IBMWatson
     #   speech recognition. For more information, see **Content types for audio-type
     #   resources** in the method description.
     #
-    #   **For an audio-type resource,** omit the header.
+    #   _For an audio-type resource_, omit the header.
     # @param allow_overwrite [Boolean] If `true`, the specified audio resource overwrites an existing audio resource with
     #   the same name. If `false`, the request fails if an audio resource with the same
     #   name already exists. The parameter has no effect if an audio resource with the
@@ -3192,9 +3283,9 @@ module IBMWatson
     # Gets information about an audio resource from a custom acoustic model. The method
     #   returns an `AudioListing` object whose fields depend on the type of audio resource
     #   that you specify with the method's `audio_name` parameter:
-    #   * **For an audio-type resource,** the object's fields match those of an
+    #   * _For an audio-type resource_, the object's fields match those of an
     #   `AudioResource` object: `duration`, `name`, `details`, and `status`.
-    #   * **For an archive-type resource,** the object includes a `container` field whose
+    #   * _For an archive-type resource_, the object includes a `container` field whose
     #   fields match those of an `AudioResource` object. It also includes an `audio`
     #   field, which contains an array of `AudioResource` objects that provides
     #   information about the audio files that are contained in the archive.
@@ -3202,14 +3293,17 @@ module IBMWatson
     #   The information includes the status of the specified audio resource. The status is
     #   important for checking the service's analysis of a resource that you add to the
     #   custom model.
-    #   * For an audio-type resource, the `status` field is located in the `AudioListing`
-    #   object.
-    #   * For an archive-type resource, the `status` field is located in the
+    #   * _For an audio-type resource_, the `status` field is located in the
+    #   `AudioListing` object.
+    #   * _For an archive-type resource_, the `status` field is located in the
     #   `AudioResource` object that is returned in the `container` field.
     #
     #   You must use credentials for the instance of the service that owns a model to list
     #   its audio resources.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing audio resources for a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
@@ -3246,10 +3340,14 @@ module IBMWatson
     #   not allow deletion of individual files from an archive resource.
     #
     #   Removing an audio resource does not affect the custom model until you train the
-    #   model on its updated data by using the **Train a custom acoustic model** method.
-    #   You can delete an existing audio resource from a model while a different resource
-    #   is being added to the model. You must use credentials for the instance of the
-    #   service that owns a model to delete its audio resources.
+    #   model on its updated data by using the [Train a custom acoustic
+    #   model](#trainacousticmodel) method. You can delete an existing audio resource from
+    #   a model while a different resource is being added to the model. You must use
+    #   credentials for the instance of the service that owns a model to delete its audio
+    #   resources.
+    #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
     #
     #   **See also:** [Deleting an audio resource from a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#deleteAudio).