docs: fix documentation structure (#949)

Co-authored-by: Astha Mohta <[email protected]>
googleapis · Jul 6, 2023 · b73e47b · b73e47b
1 parent 7e2e712
commit b73e47b
Show file tree

Hide file tree

Showing 16 changed files with 34 additions and 47 deletions.
diff --git a/docs/api-reference.rst b/docs/api-reference.rst
diff --git a/docs/client-usage.rst b/docs/client-usage.rst
@@ -1,5 +1,5 @@
-Spanner Client
-==============
+Spanner Client Usage
+====================
 
 .. _spanner-client:
 

diff --git a/docs/database-usage.rst b/docs/database-usage.rst
@@ -1,5 +1,5 @@
-Database Admin
-==============
+Database Admin Usage
+====================
 
 After creating an :class:`~google.cloud.spanner_v1.instance.Instance`, you can
 interact with individual databases for that instance.

diff --git a/docs/index.rst b/docs/index.rst
@@ -5,27 +5,48 @@
 Usage Documentation
 -------------------
 .. toctree::
-  :maxdepth: 1
-  :titlesonly:
+  :maxdepth: 2
 
   client-usage
-  instance-usage
-  database-usage
   table-usage
   batch-usage
   snapshot-usage
   transaction-usage
 
+  database-usage
+  instance-usage
+
 API Documentation
 -----------------
 .. toctree::
   :maxdepth: 1
   :titlesonly:
 
-  api-reference
   advanced-session-pool-topics
   opentelemetry-tracing
 
+  spanner_v1/client
+  spanner_v1/instance
+  spanner_v1/database
+  spanner_v1/table
+  spanner_v1/session
+  spanner_v1/keyset
+  spanner_v1/snapshot
+  spanner_v1/batch
+  spanner_v1/transaction
+  spanner_v1/streamed
+
+  spanner_v1/services
+  spanner_v1/types
+  spanner_admin_database_v1/services
+  spanner_admin_database_v1/types
+  spanner_admin_database_v1/database_admin
+  spanner_admin_instance_v1/services
+  spanner_admin_instance_v1/types
+  spanner_admin_instance_v1/instance_admin
+
+
+
 Changelog
 ---------
 

diff --git a/docs/instance-usage.rst b/docs/instance-usage.rst
@@ -1,5 +1,5 @@
-Instance Admin
-==============
+Instance Admin Usage
+====================
 
 After creating a :class:`~google.cloud.spanner_v1.client.Client`, you can
 interact with individual instances for a project.

diff --git a/docs/batch-api.rst → docs/spanner_v1/batch.rst b/docs/batch-api.rst → docs/spanner_v1/batch.rst
diff --git a/docs/client-api.rst → docs/spanner_v1/client.rst b/docs/client-api.rst → docs/spanner_v1/client.rst
diff --git a/docs/database-api.rst → docs/spanner_v1/database.rst b/docs/database-api.rst → docs/spanner_v1/database.rst
diff --git a/docs/instance-api.rst → docs/spanner_v1/instance.rst b/docs/instance-api.rst → docs/spanner_v1/instance.rst
diff --git a/docs/keyset-api.rst → docs/spanner_v1/keyset.rst b/docs/keyset-api.rst → docs/spanner_v1/keyset.rst
diff --git a/docs/session-api.rst → docs/spanner_v1/session.rst b/docs/session-api.rst → docs/spanner_v1/session.rst
diff --git a/docs/snapshot-api.rst → docs/spanner_v1/snapshot.rst b/docs/snapshot-api.rst → docs/spanner_v1/snapshot.rst
diff --git a/docs/streamed-api.rst → docs/spanner_v1/streamed.rst b/docs/streamed-api.rst → docs/spanner_v1/streamed.rst
diff --git a/docs/table-api.rst → docs/spanner_v1/table.rst b/docs/table-api.rst → docs/spanner_v1/table.rst
diff --git a/docs/transaction-api.rst → docs/spanner_v1/transaction.rst b/docs/transaction-api.rst → docs/spanner_v1/transaction.rst
diff --git a/docs/table-usage.rst b/docs/table-usage.rst
@@ -1,5 +1,5 @@
-Table Admin
-===========
+Table Admin Usage
+=================
 
 After creating an :class:`~google.cloud.spanner_v1.database.Database`, you can
 interact with individual tables for that instance.