DOC: fix some syntax errors in documents

This fixes some of reST syntax errors in the documents.