Fix RST formatting and add info how to build API docs locally
Merge pull request #110 from cdeil/docs_update2

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