can we use ".. code-block:: python" here so we get syntax highlighting?  And in the rest of the docs too.