docs: refresh list of libraries and CONTRIBUTING.rst (googleapis#9387)

busunkim96 · web-flow · commit 645822f26e0e · 2019-10-02T12:50:59.000-07:00
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -49,7 +49,7 @@ You'll have to create a development environment to hack on
    $ cd hack-on-google-cloud-python
    # Configure remotes such that you can pull changes from the google-cloud-python
    # repository into your local repository.
-   $ git remote add upstream git@github.com:GoogleCloudPlatform/google-cloud-python.git
+   $ git remote add upstream git@github.com:googleapis/google-cloud-python.git
    # fetch and merge changes from upstream into master
    $ git fetch upstream
    $ git merge upstream/master
@@ -60,23 +60,25 @@ repo, from which you can submit a pull request.
 To work on the codebase and run the tests, we recommend using ``nox``,
 but you can also use a ``virtualenv`` of your own creation.
 
-.. _repo: https://github.com/GoogleCloudPlatform/google-cloud-python
+.. _repo: https://github.com/googleapis/google-cloud-python
 
 Using ``nox``
 =============
 
 We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
-- To test your changes, run unit tests with ``nox``::
+You must install nox using Python 3.
 
-    $ nox -f datastore/noxfile.py -s unit-2.7
-    $ nox -f datastore/noxfile.py -s unit-3.7
+- To test your changes, go to the package directory and run ``nox``::
+
+    $ nox -s unit-2.7
+    $ nox -s unit-3.7
     $ ...
 
   .. note::
 
     The unit tests and system tests are contained in the individual
-    ``nox.py`` files in each directory; substitute ``datastore`` in the
+    ``noxfile.py`` files in each directory; substitute ``datastore`` in the
     example above with the package of your choice.
 
 
@@ -85,7 +87,7 @@ We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
     $ export GIT_ROOT=$(pwd)
     $ cd ${GIT_ROOT}/datastore/
-    $ nox -s "unit(py='3.7')"
+    $ nox -s unit-3.7
 
 .. nox: https://pypi.org/project/nox-automation/
 
@@ -122,9 +124,13 @@ On Debian/Ubuntu::
 Coding Style
 ************
 
-- PEP8 compliance, with exceptions defined in the linter configuration.
-  If you have ``nox`` installed, you can test that you have not introduced
-  any non-compliant code via::
+- We use the automatic code formatter ``black``. You can run it using
+  the nox session ``blacken``. This will eliminate many lint errors.
+
+   $ nox -s blacken
+
+- PEP8 compliance is required, with exceptions defined in the linter configuration.
+  You can test for non-compliant code via::
 
    $ nox -s lint
 
@@ -135,8 +141,8 @@ Coding Style
    export GOOGLE_CLOUD_TESTING_BRANCH="master"
 
   By doing this, you are specifying the location of the most up-to-date
-  version of ``google-cloud-python``. The the suggested remote name ``upstream``
-  should point to the official ``GoogleCloudPlatform`` checkout and the
+  version of ``google-cloud-python``. The suggested remote name ``upstream``
+  should point to the official ``googleapis`` checkout and the
   the branch should be the main branch on that remote (``master``).
 
 Exceptions to PEP8:
@@ -149,10 +155,11 @@ Exceptions to PEP8:
 Running System Tests
 ********************
 
-- To run system tests for a given package, you can execute::
+- To run system tests for a given package, go to the package directory
+  and execute::
 
-   $ nox -f datastore/noxfile.py -s system-3.7
-   $ nox -f datastore/noxfile.py -s system-2.7
+   $ nox -s system-3.7
+   $ nox -s system-2.7
 
   .. note::
 
@@ -216,9 +223,10 @@ Running System Tests
 Running Generated Sample Tests
 ******************************
 
-- To run system tests for a given package, you can execute::
+- To run system tests for a given package, go to the package directory 
+  and execute::
 
-   $ nox -f speech/noxfile.py -s samples
+   $ nox -s samples
 
   .. note::
 
@@ -246,33 +254,13 @@ documentation in this package which references that API or behavior must be
 changed to reflect the bug fix, ideally in the same commit that fixes the bug
 or adds the feature.
 
-To build and review docs (where ``${VENV}`` refers to the virtualenv you're
-using to develop ``google-cloud-python``):
-
-#. After following the steps above in "Using a Development Checkout", install
-   Sphinx and all development requirements in your virtualenv::
-
-     $ cd ${HOME}/hack-on-google-cloud-python
-     $ ${VENV}/bin/pip install Sphinx
+To build and review docs go to the package directory and execute::
 
-#. Change into the ``docs`` directory within your ``google-cloud-python`` checkout and
-   execute the ``make`` command with some flags::
-
-     $ cd ${HOME}/hack-on-google-cloud-python/google-cloud-python/docs
-     $ make clean html SPHINXBUILD=${VENV}/bin/sphinx-build
-
-   The ``SPHINXBUILD=...`` argument tells Sphinx to use the virtualenv Python,
-   which will have both Sphinx and ``google-cloud-python`` (for API documentation
-   generation) installed.
+$ nox -s docs
 
 #. Open the ``docs/_build/html/index.html`` file to see the resulting HTML
    rendering.
 
-As an alternative to 1. and 2. above, if you have ``nox`` installed, you
-can build the docs via::
-
-   $ nox -s docs
-
 ********************************************
 Note About ``README`` as it pertains to PyPI
 ********************************************
@@ -287,13 +275,10 @@ may cause problems creating links or rendering the description.
 .. _description on PyPI: https://pypi.org/project/google-cloud/
 
 **********************
-CircleCI Configuration
+Kokoro Configuration
 **********************
 
-All build scripts in the ``.circleci/config.yml`` configuration file which have
-Python dependencies are specified in the ``nox.py`` configuration.
-They are executed in the Travis build via ``nox -s ${ENV}`` where
-``${ENV}`` is the environment being tested.
+Build scripts and configurations are in the ``.kokoro`` directory.
 
 
 *************************
diff --git a/README.rst b/README.rst
@@ -28,46 +28,71 @@ priority.
 
 The following client libraries have **GA** support:
 
--  `Google BigQuery`_ (`BigQuery README`_)
--  `Google Cloud Bigtable`_ (`Bigtable README`_)
--  `Google Cloud Datastore`_ (`Datastore README`_)
--  `Google Cloud KMS`_ (`KMS README`_)
--  `Google Cloud Natural Language`_ (`Natural Language README`_)
--  `Google Cloud Pub/Sub`_ (`Pub/Sub README`_)
--  `Google Cloud Scheduler`_ (`Scheduler README`_)
--  `Google Cloud Spanner`_ (`Spanner README`_)
--  `Google Cloud Speech`_ (`Speech README`_)
--  `Google Cloud Storage`_ (`Storage README`_)
--  `Google Cloud Tasks`_ (`Tasks README`_)
--  `Google Cloud Translation`_ (`Translation README`_)
--  `Stackdriver Logging`_ (`Logging README`_)
+-  `Google BigQuery`_ (`BigQuery README`_, `BigQuery Documentation`_)
+-  `Google Cloud Bigtable`_ (`Bigtable README`_, `Bigtable Documentation`_)
+-  `Google Cloud Datastore`_ (`Datastore README`_, `Datastore Documentation`_)
+-  `Google Cloud KMS`_ (`KMS README`_, `KMS Documentation`_)
+-  `Google Cloud Natural Language`_ (`Natural Language README`_, `Natural Language Documentation`_)
+-  `Google Cloud Pub/Sub`_ (`Pub/Sub README`_, `Pub/Sub Documentation`_)
+-  `Google Cloud Scheduler`_ (`Scheduler README`_, `Scheduler Documentation`_)
+-  `Google Cloud Spanner`_ (`Spanner README`_, `Spanner Documentation`_)
+-  `Google Cloud Speech to Text`_ (`Speech to Text README`_, `Speech to Text Documentation`_)
+-  `Google Cloud Storage`_ (`Storage README`_, `Storage Documentation`_)
+-  `Google Cloud Tasks`_ (`Tasks README`_, `Tasks Documentation`_)
+-  `Google Cloud Translation`_ (`Translation README`_, `Translation Documentation`_)
+-  `Stackdriver Logging`_ (`Logging README`_, `Logging Documentation`_)
 
 .. _Google BigQuery: https://pypi.org/project/google-cloud-bigquery/
 .. _BigQuery README: https://github.com/googleapis/google-cloud-python/tree/master/bigquery
+.. _BigQuery Documentation: https://googleapis.dev/python/bigquery/latest
+
 .. _Google Cloud Bigtable: https://pypi.org/project/google-cloud-bigtable/
 .. _Bigtable README: https://github.com/googleapis/google-cloud-python/tree/master/bigtable
+.. _Bigtable Documentation: https://googleapis.dev/python/bigtable/latest
+
 .. _Google Cloud Datastore: https://pypi.org/project/google-cloud-datastore/
 .. _Datastore README: https://github.com/googleapis/google-cloud-python/tree/master/datastore
+.. _Datastore Documentation: https://googleapis.dev/python/datastore/latest 
+
 .. _Google Cloud KMS: https://pypi.org/project/google-cloud-kms/
 .. _KMS README: https://github.com/googleapis/google-cloud-python/tree/master/kms
+.. _KMS Documentation: https://googleapis.dev/python/cloudkms/latest
+
 .. _Google Cloud Natural Language: https://pypi.org/project/google-cloud-language/
 .. _Natural Language README: https://github.com/googleapis/google-cloud-python/tree/master/language
+.. _Natural Language Documentation: https://googleapis.dev/python/language/latest
+
 .. _Google Cloud Pub/Sub: https://pypi.org/project/google-cloud-pubsub/
 .. _Pub/Sub README: https://github.com/googleapis/google-cloud-python/tree/master/pubsub
+.. _Pub/Sub Documentation: https://googleapis.dev/python/pubsub/latest
+
 .. _Google Cloud Spanner: https://pypi.org/project/google-cloud-spanner
 .. _Spanner README: https://github.com/googleapis/google-cloud-python/tree/master/spanner
-.. _Google Cloud Speech: https://pypi.org/project/google-cloud-speech/
-.. _Speech README: https://github.com/googleapis/google-cloud-python/tree/master/speech
+.. _Spanner Documentation: https://googleapis.dev/python/spanner/latest
+
+.. _Google Cloud Speech to Text: https://pypi.org/project/google-cloud-speech/
+.. _Speech to Text README: https://github.com/googleapis/google-cloud-python/tree/master/speech
+.. _Speech to Text Documentation: https://googleapis.dev/python/speech/latest
+
 .. _Google Cloud Storage: https://pypi.org/project/google-cloud-storage/
 .. _Storage README: https://github.com/googleapis/google-cloud-python/tree/master/storage
+.. _Storage Documentation: https://googleapis.dev/python/storage/latest
+
 .. _Google Cloud Tasks: https://pypi.org/project/google-cloud-tasks/
 .. _Tasks README: https://github.com/googleapis/google-cloud-python/tree/master/tasks
+.. _Tasks Documentation: https://googleapis.dev/python/cloudtasks/latest
+
 .. _Google Cloud Translation: https://pypi.org/project/google-cloud-translate/
 .. _Translation README: https://github.com/googleapis/google-cloud-python/tree/master/translate
+.. _Translation Documentation: https://googleapis.dev/python/translation/latest
+
 .. _Google Cloud Scheduler: https://pypi.org/project/google-cloud-scheduler/
 .. _Scheduler README: https://github.com/googleapis/google-cloud-python/tree/master/scheduler
+.. _Scheduler Documentation: https://googleapis.dev/python/cloudscheduler/latest
+
 .. _Stackdriver Logging: https://pypi.org/project/google-cloud-logging/
 .. _Logging README: https://github.com/googleapis/google-cloud-python/tree/master/logging
+.. _Logging Documentation: https://googleapis.dev/python/logging/latest
 
 Beta Support
 ------------
@@ -78,16 +103,21 @@ against beta libraries are addressed with a higher priority.
 
 The following client libraries have **beta** support:
 
--  `Google Cloud Firestore`_ (`Firestore README`_)
--  `Google Cloud Video Intelligence`_ (`Video Intelligence README`_)
--  `Google Cloud Vision`_ (`Vision README`_)
+-  `Google Cloud Firestore`_ (`Firestore README`_, `Firestore Documentation`_)
+-  `Google Cloud Video Intelligence`_ (`Video Intelligence README`_, `Video Intelligence Documentation`_)
+-  `Google Cloud Vision`_ (`Vision README`_, `Vision Documentation`_)
 
 .. _Google Cloud Firestore: https://pypi.org/project/google-cloud-firestore/
 .. _Firestore README: https://github.com/googleapis/google-cloud-python/tree/master/firestore
+.. _Firestore Documentation: https://googleapis.dev/python/firestore/latest
+
 .. _Google Cloud Video Intelligence: https://pypi.org/project/google-cloud-videointelligence
 .. _Video Intelligence README: https://github.com/googleapis/google-cloud-python/tree/master/videointelligence
+.. _Video Intelligence Documentation: https://googleapis.dev/python/videointelligence/latest
+
 .. _Google Cloud Vision: https://pypi.org/project/google-cloud-vision/
 .. _Vision README: https://github.com/googleapis/google-cloud-python/tree/master/vision
+.. _Vision Documentation: https://googleapis.dev/python/vision/latest
 
 
 Alpha Support
@@ -99,67 +129,106 @@ updates. See `versioning`_ for more details.
 
 The following client libraries have **alpha** support:
 
--  `Google Cloud Asset`_ (`Asset README`_)
--  `Google Cloud AutoML`_ (`AutoML README`_)
--  `Google BigQuery Data Transfer`_ (`BigQuery Data Transfer README`_)
--  `Google Cloud Bigtable - HappyBase`_ (`HappyBase README`_)
--  `Google Cloud Container`_ (`Container README`_)
--  `Google Cloud Container Analysis`_ (`Container Analysis README`_)
--  `Google Cloud Dataproc`_ (`Dataproc README`_)
--  `Google Cloud DLP`_ (`DLP README`_)
--  `Google Cloud DNS`_ (`DNS README`_)
--  `Google Cloud IoT`_ (`IoT README`_)
--  `Google Cloud Memorystore for Redis`_ (`Redis README`_)
--  `Google Cloud Recommender`_ (`Recommender README`_)
--  `Google Cloud Resource Manager`_ (`Resource Manager README`_)
--  `Google Cloud Runtime Configuration`_ (`Runtime Config README`_)
--  `Google Cloud Security Scanner`_ (`Security Scanner README`_ )
--  `Google Cloud Trace`_ (`Trace README`_)
--  `Google Cloud Text-to-Speech`_ (`Text-to-Speech README`_)
--  `Grafeas`_ (`Grafeas README`_)
--  `Stackdriver Error Reporting`_ (`Error Reporting README`_)
--  `Stackdriver Monitoring`_ (`Monitoring README`_)
+-  `Google Cloud Asset`_ (`Asset README`_, `Asset Documentation`_)
+-  `Google Cloud AutoML`_ (`AutoML README`_, `AutoML Documentation`_)
+-  `Google BigQuery Data Transfer`_ (`BigQuery Data Transfer README`_, `BigQuery Documentation`_)
+-  `Google Cloud Bigtable - HappyBase`_ (`HappyBase README`_, `HappyBase Documentation`_)
+-  `Google Cloud Container`_ (`Container README`_, `Container Documentation`_)
+-  `Google Cloud Container Analysis`_ (`Container Analysis README`_, `Container Analysis Documentation`_)
+-  `Google Cloud Dataproc`_ (`Dataproc README`_, `Dataproc Documentation`_)
+-  `Google Cloud DLP`_ (`DLP README`_, `DLP Documentation`_)
+-  `Google Cloud DNS`_ (`DNS README`_, `DNS Documentation`_)
+-  `Google Cloud IoT`_ (`IoT README`_, `IoT Documentation`_)
+-  `Google Cloud Memorystore for Redis`_ (`Redis README`_, `Redis Documentation`_)
+-  `Google Cloud Recommender`_ (`Recommender README`_, `Recommender Documentation`_)
+-  `Google Cloud Resource Manager`_ (`Resource Manager README`_, `Resource Manager Documentation`_)
+-  `Google Cloud Runtime Configuration`_ (`Runtime Config README`_, `Runtime Config Documentation`_)
+-  `Google Cloud Security Scanner`_ (`Security Scanner README`_ , `Security Scanner Documentation`_)
+-  `Google Cloud Trace`_ (`Trace README`_, `Trace Documentation`_)
+-  `Google Cloud Text-to-Speech`_ (`Text-to-Speech README`_, `Text-to-Speech Documentation`_)
+-  `Grafeas`_ (`Grafeas README`_, `Grafeas Documentation`_)
+-  `Stackdriver Error Reporting`_ (`Error Reporting README`_, `Error Reporting Documentation`_)
+-  `Stackdriver Monitoring`_ (`Monitoring README`_, `Monitoring Documentation`_)
 
 .. _Google Cloud Asset: https://pypi.org/project/google-cloud-asset/
 .. _Asset README: https://github.com/googleapis/google-cloud-python/blob/master/asset
+.. _Asset Documentation: https://googleapis.dev/python/cloudasset/latest
+
 .. _Google Cloud AutoML: https://pypi.org/project/google-cloud-automl/
 .. _AutoML README: https://github.com/googleapis/google-cloud-python/blob/master/automl
+.. _AutoML Documentation: https://googleapis.dev/python/automl/latest
+
 .. _Google BigQuery Data Transfer: https://pypi.org/project/google-cloud-bigquery-datatransfer/
 .. _BigQuery Data Transfer README: https://github.com/googleapis/google-cloud-python/tree/master/bigquery_datatransfer
+.. _BigQuery Documentation: https://googleapis.dev/python/bigquery/latest
+
 .. _Google Cloud Bigtable - HappyBase: https://pypi.org/project/google-cloud-happybase/
 .. _HappyBase README: https://github.com/googleapis/google-cloud-python-happybase
+.. _HappyBase Documentation: https://google-cloud-python-happybase.readthedocs.io/en/latest/
+
 .. _Google Cloud Container: https://pypi.org/project/google-cloud-container/
 .. _Container README: https://github.com/googleapis/google-cloud-python/tree/master/container
+.. _Container Documentation: https://googleapis.dev/python/container/latest
+
 .. _Google Cloud Container Analysis: https://pypi.org/project/google-cloud-containeranalysis/
 .. _Container Analysis README: https://github.com/googleapis/google-cloud-python/tree/master/containeranalysis
+.. _Container Analysis Documentation: https://googleapis.dev/python/containeranalysis/latest
+
 .. _Google Cloud Dataproc: https://pypi.org/project/google-cloud-dataproc/
 .. _Dataproc README: https://github.com/googleapis/google-cloud-python/tree/master/dataproc
+.. _Dataproc Documentation: https://googleapis.dev/python/dataproc/latest
+
 .. _Google Cloud DLP: https://pypi.org/project/google-cloud-dlp/
 .. _DLP README: https://github.com/googleapis/google-cloud-python/tree/master/dlp
+.. _DLP Documentation: https://googleapis.dev/python/dlp/latest
+
 .. _Google Cloud DNS: https://pypi.org/project/google-cloud-dns/
 .. _DNS README: https://github.com/googleapis/google-cloud-python/tree/master/dns
+.. _DNS Documentation: https://googleapis.dev/python/dns/latest
+
 .. _Google Cloud IoT: https://pypi.org/project/google-cloud-iot/
 .. _IoT README: https://github.com/googleapis/google-cloud-python/tree/master/iot
+.. _IoT Documentation: https://googleapis.dev/python/cloudiot/latest
+
 .. _Google Cloud Memorystore for Redis: https://pypi.org/project/google-cloud-redis/
 .. _Redis README: https://github.com/googleapis/google-cloud-python/tree/master/redis
+.. _Redis Documentation: https://googleapis.dev/python/redis/latest
+
 .. _Google Cloud Recommender: https://pypi.org/project/google-cloud-recommender/
 .. _Recommender README: https://github.com/googleapis/google-cloud-python/tree/master/recommender
+.. _Recommender Documentation: https://googleapis.dev/python/recommender/latest
+
 .. _Google Cloud Resource Manager: https://pypi.org/project/google-cloud-resource-manager/
 .. _Resource Manager README: https://github.com/googleapis/google-cloud-python/tree/master/resource_manager
+.. _Resource Manager Documentation: https://googleapis.dev/python/cloudresourcemanager/latest
+
 .. _Google Cloud Runtime Configuration: https://pypi.org/project/google-cloud-runtimeconfig/
 .. _Runtime Config README: https://github.com/googleapis/google-cloud-python/tree/master/runtimeconfig
+.. _Runtime Config Documentation: https://googleapis.dev/python/runtimeconfig/latest
+
 .. _Google Cloud Security Scanner: https://pypi.org/project/google-cloud-websecurityscanner/
 .. _Security Scanner README: https://github.com/googleapis/google-cloud-python/blob/master/websecurityscanner
+.. _Security Scanner Documentation: https://googleapis.dev/python/websecurityscanner/latest
+
 .. _Google Cloud Text-to-Speech: https://pypi.org/project/google-cloud-texttospeech/
 .. _Text-to-Speech README: https://github.com/googleapis/google-cloud-python/tree/master/texttospeech
+.. _Text-to-Speech Documentation: https://googleapis.dev/python/texttospeech/latest
+
 .. _Google Cloud Trace: https://pypi.org/project/google-cloud-trace/
 .. _Trace README: https://github.com/googleapis/google-cloud-python/tree/master/trace
+.. _Trace Documentation: https://googleapis.dev/python/cloudtrace/latest
+
 .. _Grafeas: https://pypi.org/project/grafeas/
 .. _Grafeas README: https://github.com/googleapis/google-cloud-python/tree/master/grafeas
+.. _Grafeas Documentation: https://googleapis.dev/python/grafeas/latest
+
 .. _Stackdriver Error Reporting: https://pypi.org/project/google-cloud-error-reporting/
 .. _Error Reporting README: https://github.com/googleapis/google-cloud-python/tree/master/error_reporting
+.. _Error Reporting Documentation: https://googleapis.dev/python/clouderrorreporting/latest
+
 .. _Stackdriver Monitoring: https://pypi.org/project/google-cloud-monitoring/
 .. _Monitoring README: https://github.com/googleapis/google-cloud-python/tree/master/monitoring
+.. _Monitoring Documentation: https://googleapis.dev/python/monitoring/latest
 
 .. _versioning: https://github.com/googleapis/google-cloud-python/blob/master/CONTRIBUTING.rst#versioning
 
diff --git a/iot/.repo-metadata.json b/iot/.repo-metadata.json
