This is a really good reference that adds to what the Sphinx core documentation provides: http://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html