diff --git a/docs/index.rst b/docs/index.rst
index d6a55f2..36a5072 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -11,6 +11,9 @@ OCDS Kingfisher Colab |release|
 Troubleshooting
 ---------------
 
+Using Jupyter Notebook
+^^^^^^^^^^^^^^^^^^^^^^
+
 If you are using Kingfisher Colab in a Jupyter Notebook (not on Google Colaboratory), you need to:
 
 #. Install the ``google-colab`` package:
@@ -25,6 +28,13 @@ If you are using Kingfisher Colab in a Jupyter Notebook (not on Google Colaborat
 
       pip install --upgrade ipykernel
 
+Using JSON operators with the %sql magic
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When using the ipython-sql ``%sql`` line magic, you must avoid spaces around JSON operators.
+
+E.g. ``data->'ocid'`` not ``data -> 'ocid'``
+
 API
 ---