AutoML: add proto files; add 'docs' session to 'nox'; 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/automl/synth.py.
synthtool > Ensuring dependencies.
synthtool > Pulling artman image.
latest: Pulling from googleapis/artman
Digest: sha256:d3df563538225ac6caac45d8ad86499500211d1bcb2536955a6dbda15e1b368e
Status: Image is up to date for googleapis/artman:latest
synthtool > Cloning googleapis.
synthtool > Running generator for google/cloud/automl/artman_automl_v1beta1.yaml.
synthtool > Generated code into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/text_extraction.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/text_extraction.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/io.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/io.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/classification.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/classification.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/operations.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/operations.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/tables.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/tables.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/data_stats.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/data_stats.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/ranges.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/ranges.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/column_spec.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/column_spec.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/detection.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/detection.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/dataset.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/dataset.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/model.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/model.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/data_items.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/data_items.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/annotation_payload.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/annotation_payload.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/temporal.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/temporal.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/text_sentiment.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/text_sentiment.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/model_evaluation.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/model_evaluation.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/translation.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/translation.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/service.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/service.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/image.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/image.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/prediction_service.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/prediction_service.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/table_spec.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/table_spec.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/text.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/text.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/regression.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/regression.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/data_types.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/data_types.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/geometry.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/geometry.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/text_segment.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/text_segment.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/cloud/automl/v1beta1/video.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto/video.proto
synthtool > Placed proto files into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/automl-v1beta1/google/cloud/automl_v1beta1/proto.
synthtool > Replaced 'metadata_type=operations_pb2.OperationMetadata' in google/cloud/automl_v1beta1/gapic/auto_ml_client.py.
synthtool > No replacements made in google/cloud/automl_v1beta1/gapic/prediction_service_client.py for pattern ^\s+::, maybe replacement is not longer needed?
synthtool > No replacements made in google/cloud/automl_v1beta1/gapic/auto_ml_client.py for pattern ^(\s+)(::)

\s+?([^\s]), maybe replacement is not longer needed?
.coveragerc
.flake8
MANIFEST.in
noxfile.py.j2
setup.cfg
Running session blacken
Creating virtualenv using python3.6 in /tmpfs/src/git/autosynth/working_repo/automl/.nox/blacken
pip install black
black google tests docs
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/__init__.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/enums.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client_config.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client_config.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/transports/auto_ml_grpc_transport.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/transports/prediction_service_grpc_transport.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/classification_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_items_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_items_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/classification_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_types_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/dataset_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_types_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/detection_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/geometry_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/geometry_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/dataset_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/image_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/detection_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/io_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/image_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/model_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/operations_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/model_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/ranges_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/ranges_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/regression_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/regression_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/io_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/operations_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/tables_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/service_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/temporal_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/temporal_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/tables_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/translation_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/video_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/video_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/types.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/translation_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/tests/unit/gapic/v1beta1/test_prediction_service_client_v1beta1.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/tests/unit/gapic/v1beta1/test_auto_ml_client_v1beta1.py
reformatted /tmpfs/src/git/autosynth/working_repo/automl/google/cloud/automl_v1beta1/proto/service_pb2.py
All done! ✨ 🍰 ✨
66 files reformatted, 6 files left unchanged.
Session blacken was successful.
synthtool > Cleaned up 2 temporary directories.
synthtool > Wrote metadata to synth.metadata.

Broken docs build.

[tseaver]

Fixing the mangled generation requires one of:

• Lobby for removing those lines from the .proto file.
• Tweak the gapic-generator to avoid injecting the :raw-latex: bits.
• Fixing up the mangling (deleting the example?) in synth.py.