docs(speech): update docstrings (via synth)

[yoshi-automation]

This PR was generated using Autosynth. 🌈

Here's the log from Synthtool:

synthtool > Executing /tmpfs/src/git/autosynth/working_repo/speech/synth.py.
synthtool > Ensuring dependencies.
synthtool > Pulling artman image.
latest: Pulling from googleapis/artman
Digest: sha256:6068f67900a3f0bdece596b97bda8fc70406ca0e137a941f4c81d3217c994a80
Status: Image is up to date for googleapis/artman:latest
synthtool > Cloning googleapis.
synthtool > Running generator for google/cloud/speech/artman_speech_v1p1beta1.yaml.
synthtool > Generated code into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/cloud_speech.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/google/cloud/speech_v1p1beta1/proto/cloud_speech.proto
synthtool > Placed proto files into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/google/cloud/speech_v1p1beta1/proto.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_auto_punctuation_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_transcribe_auto_punctuation_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_quickstart_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_quickstart_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_diarization_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_transcribe_diarization_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_multilanguage_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_transcribe_multilanguage_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_recognition_metadata_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_transcribe_recognition_metadata_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_word_level_confidence_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_transcribe_word_level_confidence_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_contexts_classes_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_contexts_classes_beta.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_adaptation_beta.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/v1p1beta1/test/speech_adaptation_beta.test.yaml
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.mp3 to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/brooklyn_bridge.mp3
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.raw to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/brooklyn_bridge.raw
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.flac to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/brooklyn_bridge.flac
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/brooklyn_bridge.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/hello.raw to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/hello.raw
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/hello.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/hello.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/multi.flac to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/multi.flac
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/multi.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/multi.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/commercial_mono.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1p1beta1/samples/resources/commercial_mono.wav
synthtool > Writing samples manifest ['gen-manifest', '--env=python', '--bin=python3', '--output=v1p1beta1/test/samples.manifest.yaml', '--chdir={@manifest_dir}/../..', 'v1p1beta1/speech_contexts_classes_beta.py', 'v1p1beta1/speech_transcribe_multilanguage_beta.py', 'v1p1beta1/speech_transcribe_auto_punctuation_beta.py', 'v1p1beta1/speech_adaptation_beta.py', 'v1p1beta1/speech_transcribe_diarization_beta.py', 'v1p1beta1/speech_quickstart_beta.py', 'v1p1beta1/speech_transcribe_recognition_metadata_beta.py', 'v1p1beta1/speech_transcribe_word_level_confidence_beta.py']
synthtool > Running generator for google/cloud/speech/artman_speech_v1.yaml.
synthtool > Generated code into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/cloud_speech.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/google/cloud/speech_v1/proto/cloud_speech.proto
synthtool > Placed proto files into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/google/cloud/speech_v1/proto.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_gcs.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_async_gcs.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_word_time_offsets_gcs.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_async_word_time_offsets_gcs.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_model_selection.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_multichannel.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection_gcs.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_model_selection_gcs.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync_gcs.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_sync_gcs.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_enhanced_model.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_enhanced_model.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_async.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel_gcs.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_multichannel_gcs.test.yaml
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync.test.yaml to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/v1/test/speech_transcribe_sync.test.yaml
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.mp3 to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/brooklyn_bridge.mp3
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.raw to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/brooklyn_bridge.raw
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.flac to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/brooklyn_bridge.flac
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/brooklyn_bridge.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/brooklyn_bridge.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/hello.raw to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/hello.raw
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/hello.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/hello.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/multi.flac to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/multi.flac
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/multi.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/multi.wav
synthtool > Download https://storage.googleapis.com/cloud-samples-data/speech/commercial_mono.wav to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/speech-v1/samples/resources/commercial_mono.wav
synthtool > Writing samples manifest ['gen-manifest', '--env=python', '--bin=python3', '--output=v1/test/samples.manifest.yaml', '--chdir={@manifest_dir}/../..', 'v1/speech_transcribe_multichannel.py', 'v1/speech_transcribe_sync_gcs.py', 'v1/speech_transcribe_async_gcs.py', 'v1/speech_transcribe_multichannel_gcs.py', 'v1/speech_transcribe_async.py', 'v1/speech_transcribe_model_selection_gcs.py', 'v1/speech_transcribe_async_word_time_offsets_gcs.py', 'v1/speech_transcribe_enhanced_model.py', 'v1/speech_transcribe_model_selection.py', 'v1/speech_transcribe_sync.py']
synthtool > Replaced 'from google\\.cloud import speech_(.+?)$' in tests/unit/gapic/v1/test_speech_client_v1.py.
synthtool > Replaced 'from google\\.cloud import speech_(.+?)$' in tests/unit/gapic/v1p1beta1/test_speech_client_v1p1beta1.py.
.coveragerc
.flake8
MANIFEST.in
noxfile.py.j2
setup.cfg
Running session blacken
Creating virtual environment (virtualenv) using python3.6 in .nox/blacken
pip install black==19.3b0
black docs google tests noxfile.py setup.py samples
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/gapic/speech_client_config.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/gapic/enums.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/gapic/transports/speech_grpc_transport.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/proto/cloud_speech_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/types.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/gapic/enums.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/gapic/speech_client.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/gapic/speech_client_config.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/gapic/transports/speech_grpc_transport.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/gapic/speech_client.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/types.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_async.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_async_gcs.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_async_word_time_offsets_gcs.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_enhanced_model.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_model_selection.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_model_selection_gcs.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_multichannel.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_multichannel_gcs.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_sync.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1/speech_transcribe_sync_gcs.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_adaptation_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_contexts_classes_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_quickstart_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_transcribe_auto_punctuation_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_transcribe_diarization_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_transcribe_multilanguage_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_transcribe_recognition_metadata_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/samples/v1p1beta1/speech_transcribe_word_level_confidence_beta.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/tests/unit/gapic/v1p1beta1/test_speech_client_v1p1beta1.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/tests/unit/gapic/v1/test_speech_client_v1.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1/proto/cloud_speech_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2.py
All done! ✨ 🍰 ✨
35 files reformatted, 17 files left unchanged.
Session blacken was successful.
synthtool > Cleaned up 2 temporary directories.
synthtool > Wrote metadata to synth.metadata.

[tseaver]

Kokoro docs failure seemed to be a transient failure to load the requests object inventory.