v1.rb in google-cloud-speech-0.31.0

- old
+ new

@@ -10,34 +10,40 @@
 # distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "google/cloud/speech/v1/speech_client"
 require "google/cloud/speech/v1/helpers"
 
 module Google
   module Cloud
     module Speech
       # rubocop:disable LineLength
 
       ##
-      # # Ruby Client for Google Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+      # # Ruby Client for Cloud Speech API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
       #
-      # [Google Cloud Speech API][Product Documentation]:
-      # Google Cloud Speech API.
+      # [Cloud Speech API][Product Documentation]:
+      # Converts audio to text by applying powerful neural network models.
       # - [Product Documentation][]
       #
       # ## Quick Start
       # In order to use this library, you first need to go through the following
       # steps:
       #
       # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
       # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
-      # 3. [Enable the Google Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
+      # 3. [Enable the Cloud Speech API.](https://console.cloud.google.com/apis/library/speech.googleapis.com)
       # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
       #
+      # ### Installation
+      # ```
+      # $ gem install google-cloud-speech
+      # ```
+      #
       # ### Preview
       # #### SpeechClient
       # ```rb
       # require "google/cloud/speech"
       #
@@ -54,10 +60,10 @@
       # audio = { uri: uri }
       # response = speech_client.recognize(config, audio)
       # ```
       #
       # ### Next Steps
-      # - Read the [Google Cloud Speech API Product documentation][Product Documentation]
+      # - Read the [Cloud Speech API Product documentation][Product Documentation]
       #   to learn more about the product and see How-to Guides.
       # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
       #   to see the full list of Cloud APIs that we cover.
       #
       # [Product Documentation]: https://cloud.google.com/speech