Fix RST formatting and add info how to build API docs locally

Sorry ... screwed up the the docs_update PR. Please merge.