docs: clarify %%bigquery` magics and fix broken link (#508)

googleapis · Feb 16, 2021 · eedf93b · eedf93b
1 parent 9902789
commit eedf93b
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 2 deletions.
diff --git a/docs/usage/index.rst b/docs/usage/index.rst
@@ -29,7 +29,7 @@ Integrations with Other Libraries
 
   pandas
 
-See also, the :mod:`google.cloud.bigquery.magics` module for integrations
-with Jupyter.
+See also, the :mod:`google.cloud.bigquery.magics.magics` module for
+integrations with Jupyter.
 
 
diff --git a/google/cloud/bigquery/magics/magics.py b/google/cloud/bigquery/magics/magics.py
@@ -14,6 +14,15 @@
 
 """IPython Magics
 
+To use these magics, you must first register them. Run the ``%load_ext`` magic
+in a Jupyter notebook cell.
+
+.. code::
+
+    %load_ext google.cloud.bigquery
+
+This makes the ``%%bigquery`` magic available.
+
 .. function:: %%bigquery
 
     IPython cell magic to run a query and display the result as a DataFrame