Move howto to usage directory

googleapis · Oct 19, 2018 · 75972b1 · 75972b1
1 parent c286e23
commit 75972b1
Show file tree

Hide file tree

Showing 10 changed files with 42 additions and 37 deletions.
diff --git a/bigquery/docs/index.rst b/bigquery/docs/index.rst
@@ -1,43 +1,13 @@
 .. include:: /../bigquery/README.rst
 
-BigQuery Basics
-~~~~~~~~~~~~~~~
-
-.. toctree::
-  :maxdepth: 1
-
-  howto/client
-  howto/queries
-
-Working with BigQuery Resources
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. toctree::
-  :maxdepth: 1
-
-  howto/datasets
-  howto/tables
-  howto/encryption
-  howto/jobs
-
-Integrations with Other Libraries
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. toctree::
-  :maxdepth: 1
-
-  howto/pandas
-
-See also, the :mod:`google.cloud.bigquery.magics` module for integrations
-with Jupyter.
-
 More Examples
 ~~~~~~~~~~~~~
 
-See the `official Google BigQuery how-to guides
-<https://cloud.google.com/bigquery/docs/how-to>`_ for more in-depth
-information and code samples on using the ``google-cloud-bigquery`` library
-with the BigQuery API.
+.. toctree::
+  :maxdepth: 2
+
+  usage/index
+  Official Google BigQuery How-to Guides <https://cloud.google.com/bigquery/docs/how-to>
 
 API Reference
 -------------

diff --git a/bigquery/docs/usage.html b/bigquery/docs/usage.html
@@ -1,8 +1,8 @@
 <html>
 <head>
- <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <meta http-equiv="refresh" content="1; url=./usage/index.html:" />
  <script>
-   window.location.href = "./index.html"
+   window.location.href = "./usage/index.html"
  </script>
 </head>
 </html>
diff --git a/bigquery/docs/howto/client.rst → bigquery/docs/usage/client.rst b/bigquery/docs/howto/client.rst → bigquery/docs/usage/client.rst
diff --git a/bigquery/docs/howto/datasets.rst → bigquery/docs/usage/datasets.rst b/bigquery/docs/howto/datasets.rst → bigquery/docs/usage/datasets.rst
diff --git a/bigquery/docs/howto/encryption.rst → bigquery/docs/usage/encryption.rst b/bigquery/docs/howto/encryption.rst → bigquery/docs/usage/encryption.rst
diff --git a/bigquery/docs/usage/index.rst b/bigquery/docs/usage/index.rst
@@ -0,0 +1,35 @@
+Usage Guides
+~~~~~~~~~~~~
+
+BigQuery Basics
+^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  client
+  queries
+
+Working with BigQuery Resources
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  datasets
+  tables
+  encryption
+  jobs
+
+Integrations with Other Libraries
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  pandas
+
+See also, the :mod:`google.cloud.bigquery.magics` module for integrations
+with Jupyter.
+
+
diff --git a/bigquery/docs/howto/jobs.rst → bigquery/docs/usage/jobs.rst b/bigquery/docs/howto/jobs.rst → bigquery/docs/usage/jobs.rst
diff --git a/bigquery/docs/howto/pandas.rst → bigquery/docs/usage/pandas.rst b/bigquery/docs/howto/pandas.rst → bigquery/docs/usage/pandas.rst
diff --git a/bigquery/docs/howto/queries.rst → bigquery/docs/usage/queries.rst b/bigquery/docs/howto/queries.rst → bigquery/docs/usage/queries.rst
diff --git a/bigquery/docs/howto/tables.rst → bigquery/docs/usage/tables.rst b/bigquery/docs/howto/tables.rst → bigquery/docs/usage/tables.rst