DNS: Prep docs for repo split.

dns/README.rst

@@ -1,53 +1,78 @@
 Python Client for Google Cloud DNS
 ==================================
 
-    Python idiomatic client for `Google Cloud DNS`_
+The `Google Cloud DNS`_ API provides methods that you can use to
+manage DNS for your applications.
 
-.. _Google Cloud DNS: https://cloud.google.com/dns/
 
 |pypi| |versions|
 
--  `Documentation`_
+- `Client Library Documentation`_
+- `Product Documentation`_
 
-.. _Documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/dns/usage.html
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dns.svg
+   :target: https://pypi.org/project/google-cloud-dns/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dns.svg
+.. _Google Cloud DNS: https://cloud.google.com/dns/
+   :target: https://pypi.org/project/google-cloud-dns/
+.. _Client Library Documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/dns/index.html
+.. _Product Documentation: https://cloud.google.com/dns/docs/
 
 Quick Start
 -----------
 
-.. code-block:: console
+In order to use this library, you first need to go through the following steps:
 
-    $ pip install --upgrade google-cloud-dns
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Datastore API.`_
+4. `Setup Authentication.`_
 
-For more information on setting up your Python development environment,
-such as installing ``pip`` and ``virtualenv`` on your system, please refer
-to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
+.. _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 Google Cloud Datastore API.:  https://cloud.google.com/datastore
+.. _Setup Authentication.: https://googlecloudplatform.github.io/google-cloud-python/latest/core/auth.html
 
-.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
+Installation
+~~~~~~~~~~~~
 
-Authentication
---------------
+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 ``google-cloud-python`` we try to make authentication as painless as
-possible. Check out the `Authentication section`_ in our documentation to
-learn more. You may also find the `authentication document`_ shared by all
-the ``google-cloud-*`` libraries to be helpful.
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
 
-.. _Authentication section: https://google-cloud-python.readthedocs.io/en/latest/core/auth.html
-.. _authentication document: https://github.com/GoogleCloudPlatform/google-cloud-common/tree/master/authentication
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
 
-Using the API
--------------
 
-The Cloud `DNS`_ API (`DNS API docs`_) provides methods that you can use to
-manage DNS for your applications.
+Mac/Linux
+^^^^^^^^^
 
-.. _DNS: https://cloud.google.com/dns/
-.. _DNS API docs: https://cloud.google.com/dns/docs/apis
+.. code-block:: console
 
-See the ``google-cloud-python`` API DNS `Documentation`_ to learn
-how to manage DNS records using this Client Library.
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-datastore
 
-.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dns.svg
-   :target: https://pypi.org/project/google-cloud-dns/
-.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dns.svg
-   :target: https://pypi.org/project/google-cloud-dns/
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-datastore
+
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud DNS
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.

docs/dns/usage.rst → dns/docs/index.rst

@@ -1,26 +1,10 @@
-DNS
-===
+.. include:: /../dns/README.rst
 
-.. toctree::
-  :maxdepth: 2
-  :hidden:
-
-  client
-  zone
-  resource-record-set
-  changes
-
-Installation
-------------
-
-Install the ``google-cloud-dns`` library using ``pip``:
-
-.. code-block:: console
-
-    $ pip install google-cloud-dns
+Using the Library
+-----------------
 
 Client
-------
+~~~~~~
 
 :class:`Client <google.cloud.dns.client.Client>` objects provide a means to
 configure your DNS applications.  Each instance holds both a ``project``
@@ -37,7 +21,7 @@ create an instance of :class:`Client <google.cloud.dns.client.Client>`.
      >>> client = dns.Client()
 
 Projects
---------
+~~~~~~~~
 
 A project is the top-level container in the ``DNS`` API:  it is tied
 closely to billing, and can provide default access control across all its
@@ -55,7 +39,7 @@ To override the project inferred from the environment, pass an explicit
      >>> client = dns.Client(project='PROJECT_ID')
 
 Project Quotas
---------------
+~~~~~~~~~~~~~~
 
 Query the quotas for a given project:
 
@@ -75,15 +59,15 @@ Query the quotas for a given project:
 
 
 Project ACLs
-~~~~~~~~~~~~
+^^^^^^^^^^^^
 
 Each project has an access control list granting reader / writer / owner
 permission to one or more entities.  This list cannot be queried or set
 via the API:  it must be managed using the Google Developer Console.
 
 
 Managed Zones
--------------
+~~~~~~~~~~~~~
 
 A "managed zone" is the container for DNS records for the same DNS name
 suffix and has a set of name servers that accept and responds to queries:
@@ -113,7 +97,7 @@ List the zones for a given project:
 
 
 Resource Record Sets
---------------------
+~~~~~~~~~~~~~~~~~~~~
 
 Each managed zone exposes a read-only set of resource records:
 
@@ -145,7 +129,7 @@ Each managed zone exposes a read-only set of resource records:
 
 
 Change requests
----------------
+~~~~~~~~~~~~~~~
 
 Update the resource record set for a zone by creating a change request
 bundling additions to or deletions from the set.
@@ -194,13 +178,24 @@ List changes made to the resource record set for a given zone:
       ...         page_token=page_token)  # API request
       ...     changes.extend(next_batch)
 
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   client
+   zone
+   resource-record-set
+   changes
+
 Changelog
 ---------
 
 For a list of all ``google-cloud-dns`` releases:
 
 .. toctree::
-  :maxdepth: 2
+   :maxdepth: 2
 
-  changelog
+   changelog
 

dns/docs/usage.html

@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>

docs/conf.py

@@ -330,6 +330,7 @@
 # HTML pages to be copied from source to target
 static_html_pages = [
     'datastore/usage.html',
+    'dns/usage.html',
     'bigquery/usage.html',
     'spanner/usage.html',
 ]

docs/dns

@@ -0,0 +1 @@
+../dns/docs

docs/index.rst

@@ -12,7 +12,7 @@
   Dataproc <dataproc/index>
   Datastore <datastore/index>
   Data Loss Prevention <dlp/index>
-  DNS <dns/usage>
+  DNS <dns/index>
   Firestore <firestore/index>
   IoT <iot/index>
   Key Management <kms/index>