.. BEGIN setup/comments -------------------------------------------------------

   The heading hierarchy is defined as:
        h1: =
        h2: -
        h3: ^
        h4: ~
        h5: "
        h6: #

.. support inline python code highlighting using :python:`foo = bar(5)`
.. role:: python(code)
   :language: python


.. BEGIN document -------------------------------------------------------------

.. mdinclude:: ../README.md