chore(services): update service information

Author: ehdsouza

ibm_watson/assistant_v1.py

@@ -17,6 +17,8 @@
 The IBM Watson™ Assistant service combines machine learning, natural language
 understanding, and an integrated dialog editor to create conversation flows between your
 apps and your users.
+The Assistant v1 API provides authoring methods your application can use to create or
+update a workspace.
 """
 
 import json
@@ -98,8 +100,8 @@ def message(self,
         Get response to user input.
 
         Send user input to a workspace and receive a response.
-        **Note:** For most applications, there are significant advantages to using the v2
-        runtime API instead. These advantages include ease of deployment, automatic state
+        **Important:** This method has been superseded by the new v2 runtime API. The v2
+        API offers significant advantages, including ease of deployment, automatic state
         management, versioning, and search capabilities. For more information, see the
         [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-overview).
         There is no rate limit for this operation.

ibm_watson/assistant_v2.py

@@ -17,6 +17,8 @@
 The IBM Watson™ Assistant service combines machine learning, natural language
 understanding, and an integrated dialog editor to create conversation flows between your
 apps and your users.
+The Assistant v2 API provides runtime methods your client application can use to send user
+input to an assistant and receive a response.
 """
 
 import json

ibm_watson/text_to_speech_v1.py

@@ -178,50 +178,42 @@ def synthesize(self,
          The service can return audio in the following formats (MIME types).
         * Where indicated, you can optionally specify the sampling rate (`rate`) of the
         audio. You must specify a sampling rate for the `audio/l16` and `audio/mulaw`
-        formats. A specified sampling rate must lie in the range of 8 kHz to 192 kHz.
+        formats. A specified sampling rate must lie in the range of 8 kHz to 192 kHz. Some
+        formats restrict the sampling rate to certain values, as noted.
         * For the `audio/l16` format, you can optionally specify the endianness
         (`endianness`) of the audio: `endianness=big-endian` or
         `endianness=little-endian`.
         Use the `Accept` header or the `accept` parameter to specify the requested format
         of the response audio. If you omit an audio format altogether, the service returns
         the audio in Ogg format with the Opus codec (`audio/ogg;codecs=opus`). The service
         always returns single-channel audio.
-        * `audio/basic`
-          The service returns audio with a sampling rate of 8000 Hz.
-        * `audio/flac`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/l16`
-          You must specify the `rate` of the audio. You can optionally specify the
-        `endianness` of the audio. The default endianness is `little-endian`.
-        * `audio/mp3`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/mpeg`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/mulaw`
-          You must specify the `rate` of the audio.
-        * `audio/ogg`
-          The service returns the audio in the `vorbis` codec. You can optionally specify
-        the `rate` of the audio. The default sampling rate is 22,050 Hz.
-        * `audio/ogg;codecs=opus`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/ogg;codecs=vorbis`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/wav`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
-        * `audio/webm`
-          The service returns the audio in the `opus` codec. The service returns audio
-        with a sampling rate of 48,000 Hz.
-        * `audio/webm;codecs=opus`
-          The service returns audio with a sampling rate of 48,000 Hz.
-        * `audio/webm;codecs=vorbis`
-          You can optionally specify the `rate` of the audio. The default sampling rate is
-        22,050 Hz.
+        * `audio/basic` - The service returns audio with a sampling rate of 8000 Hz.
+        * `audio/flac` - You can optionally specify the `rate` of the audio. The default
+        sampling rate is 22,050 Hz.
+        * `audio/l16` - You must specify the `rate` of the audio. You can optionally
+        specify the `endianness` of the audio. The default endianness is `little-endian`.
+        * `audio/mp3` - You can optionally specify the `rate` of the audio. The default
+        sampling rate is 22,050 Hz.
+        * `audio/mpeg` - You can optionally specify the `rate` of the audio. The default
+        sampling rate is 22,050 Hz.
+        * `audio/mulaw` - You must specify the `rate` of the audio.
+        * `audio/ogg` - The service returns the audio in the `vorbis` codec. You can
+        optionally specify the `rate` of the audio. The default sampling rate is 22,050
+        Hz.
+        * `audio/ogg;codecs=opus` - You can optionally specify the `rate` of the audio.
+        Only the following values are valid sampling rates: `48000`, `24000`, `16000`,
+        `12000`, or `8000`. If you specify a value other than one of these, the service
+        returns an error. The default sampling rate is 48,000 Hz.
+        * `audio/ogg;codecs=vorbis` - You can optionally specify the `rate` of the audio.
+        The default sampling rate is 22,050 Hz.
+        * `audio/wav` - You can optionally specify the `rate` of the audio. The default
+        sampling rate is 22,050 Hz.
+        * `audio/webm` - The service returns the audio in the `opus` codec. The service
+        returns audio with a sampling rate of 48,000 Hz.
+        * `audio/webm;codecs=opus` - The service returns audio with a sampling rate of
+        48,000 Hz.
+        * `audio/webm;codecs=vorbis` - You can optionally specify the `rate` of the audio.
+        The default sampling rate is 22,050 Hz.
         For more information about specifying an audio format, including additional
         details about some of the formats, see [Audio
         formats](https://cloud.ibm.com/docs/services/text-to-speech?topic=text-to-speech-audioFormats#audioFormats).