From 08304ea8c2e370c5b3c7a015e6af0d00330ed1be Mon Sep 17 00:00:00 2001
From: Troy Raen <raen@ipac.caltech.edu>
Date: Sun, 30 Jun 2024 16:52:53 -0700
Subject: [PATCH] fixup docs

---
 docs/source/api-reference/index.rst    | 18 ++++++++++--------
 docs/source/index.rst                  |  1 -
 docs/source/one-time-setup/install.rst |  2 +-
 pittgoogle/bigquery.py                 | 10 ++++++++++
 4 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/docs/source/api-reference/index.rst b/docs/source/api-reference/index.rst
index ce3c81b..372ecaf 100644
--- a/docs/source/api-reference/index.rst
+++ b/docs/source/api-reference/index.rst
@@ -6,11 +6,13 @@ pittgoogle
 
 .. autosummary::
 
-    pittgoogle.Alert
-    pittgoogle.Auth
-    pittgoogle.Consumer
-    pittgoogle.ProjectIds
-    pittgoogle.Schemas
-    pittgoogle.Subscription
-    pittgoogle.Table
-    pittgoogle.Topic
+    .. autosummary::
+
+        pittgoogle.alert.Alert
+        pittgoogle.auth.Auth
+        pittgoogle.bigquery.Table
+        pittgoogle.pubsub.Consumer
+        pittgoogle.pubsub.Subscription
+        pittgoogle.pubsub.Topic
+        pittgoogle.registry.ProjectIds
+        pittgoogle.registry.Schemas
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 6354e66..7894714 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -18,7 +18,6 @@ If you run into trouble, please
     :maxdepth: 1
 
     listings
-    Install<one-time-setup/install>
     one-time-setup/index
     faq/index
     for-developers/index
diff --git a/docs/source/one-time-setup/install.rst b/docs/source/one-time-setup/install.rst
index 2e512ec..863406e 100644
--- a/docs/source/one-time-setup/install.rst
+++ b/docs/source/one-time-setup/install.rst
@@ -1,7 +1,7 @@
 .. _install:
 
 Install pittgoogle-client
--------------------------
+=========================
 
 .. automodule:: pittgoogle
 
diff --git a/pittgoogle/bigquery.py b/pittgoogle/bigquery.py
index 668c370..3cbe921 100644
--- a/pittgoogle/bigquery.py
+++ b/pittgoogle/bigquery.py
@@ -29,6 +29,8 @@ class Table:
         client (google.cloud.bigquery.Client, optional):
             BigQuery client that will be used to access the table.
             If not provided, a new client will be created the first time it is requested.
+
+    ----
     """
 
     # Strings _below_ the field will make these also show up as individual properties in rendered docs.
@@ -134,6 +136,10 @@ def table(self) -> google.cloud.bigquery.Table:
         """Google Cloud BigQuery Table object that is connected to the Cloud resource.
 
         Makes a `get_table` request if necessary.
+
+        Returns:
+            google.cloud.bigquery.Table:
+                The BigQuery Table object, connected to the Cloud resource.
         """
         if self._table is None:
             self._table = self.client.get_table(self.id)
@@ -144,6 +150,10 @@ def client(self) -> google.cloud.bigquery.Client:
         """Google Cloud BigQuery Client used to access the table.
 
         This will be created using :attr:`Table.auth` if necessary.
+
+        Returns:
+            google.cloud.bigquery.Client:
+                The BigQuery client instance.
         """
         if self._client is None:
             self._client = google.cloud.bigquery.Client(credentials=self.auth.credentials)