You don't need ``..math::``. It's a sphinx http://sphinx-doc.org/index.html markup.

Also you don't need to putting function signature there it's automatically dumped. It didn't hurt anything putting it there though.

To make sure the doc is formatted correctly
 * install sphinx (pip install sphinx)
 * go to ``doc`` directory
 * type ``make html``
 * the output should be in ``_build/html/index.html``

Don't worry about uploading doc it's a little tricky. Just make sure make doc gives a reasonable output. I can take care of uploading it.