[CHANGE ME] Re-generated iot to pick up changes in the API or client library generator.

Author: yoshi-automation

iot/docs/index.rst

@@ -1,20 +1,103 @@
-.. include:: README.rst
+Python Client for Cloud IoT API (`Alpha`_)
+==========================================
 
-Api Reference
--------------
-.. toctree::
- :maxdepth: 2
+`Cloud IoT API`_: Registers and manages IoT (Internet of Things) devices that connect to the
+Google Cloud Platform.
 
- gapic/v1/api
- gapic/v1/types
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Cloud IoT API: https://cloud.google.com/iot
+.. _Client Library Documentation: https://googleapis.github.io/google-cloud-python/latest/iot/usage.html
+.. _Product Documentation: https://cloud.google.com/iot
+
+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.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud IoT API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud IoT API.: https://cloud.google.com/iot
+.. _Setup Authentication.: https://googleapis.github.io/google-cloud-python/latest/core/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
 
+ pip install virtualenv
+ virtualenv <your-env>
+ source <your-env>/bin/activate
+ <your-env>/bin/pip install google-cloud-iot
 
-Changelog
----------
 
-For a list of all ``google-cloud-iot`` releases:
+Windows
+^^^^^^^
 
+.. code-block:: console
+
+ pip install virtualenv
+ virtualenv <your-env>
+ <your-env>\Scripts\activate
+ <your-env>\Scripts\pip.exe install google-cloud-iot
+
+Preview
+~~~~~~~
+
+DeviceManagerClient
+^^^^^^^^^^^^^^^^^^^
+
+.. code:: py
+
+ from google.cloud import iot_v1
+
+ client = iot_v1.DeviceManagerClient()
+
+ parent = client.location_path('[PROJECT]', '[LOCATION]')
+
+ # Iterate over all results
+ for element in client.list_device_registries(parent):
+ # process element
+ pass
+
+Next Steps
+~~~~~~~~~~
+
+- Read the `Client Library Documentation`_ for Cloud IoT API
+ API to see other available methods on the client.
+- Read the `Cloud IoT API Product documentation`_ to learn
+ more about the product and see How-to Guides.
+- View this `repository’s main README`_ to see the full list of Cloud
+ APIs that we cover.
+
+.. _Cloud IoT API Product documentation: https://cloud.google.com/iot
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+
+Api Reference
+-------------
 .. toctree::
- :maxdepth: 2
+  :maxdepth: 2
 
- changelog
+ gapic/v1/api
+ gapic/v1/types

iot/synth.metadata

@@ -1,5 +1,5 @@
 {
- "updateTime": "2019-04-30T21:43:21.680465Z",
+ "updateTime": "2019-05-01T12:12:19.124173Z",
  "sources": [
  {
  "generator": {
@@ -20,7 +20,7 @@
  "template": {
  "name": "python_library",
  "origin": "synthtool.gcp",
- "version": "2019.4.24"
+ "version": "2019.4.10"
  }
  }
  ],