Generating TOC in README.rst #

One advantage of reStructuredText over Markdown is that you can get a table of contents automatically, line this:

.. contents:: Table of Contents


Title
=====

Subtitle
--------

-  An item


Another subtitle
----------------

-  Another bullet point