docs: include details of inherited class members (#64)

* docs: include details of inherited class members * Clarify result() return type for special queries
googleapis · Mar 26, 2020 · 9ada7a5 · 9ada7a5
1 parent f154b78
commit 9ada7a5
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 1 deletion.
diff --git a/docs/conf.py b/docs/conf.py
@@ -42,7 +42,7 @@
 
 # autodoc/autosummary flags
 autoclass_content = "both"
-autodoc_default_flags = ["members"]
+autodoc_default_flags = ["members", "inherited-members"]
 autosummary_generate = True
 
 

diff --git a/google/cloud/bigquery/job.py b/google/cloud/bigquery/job.py
@@ -3168,6 +3168,9 @@ def result(
                 set** (this is distinct from the total number of rows in the
                 current page: ``iterator.page.num_items``).
 
+                If the query is a special query that produces no results, e.g.
+                a DDL query, an ``_EmptyRowIterator`` instance is returned.
+
         Raises:
             google.cloud.exceptions.GoogleCloudError:
                 If the job failed.