FIX: Typos and style details
Merge pull request #183 from blagarde/python_api_doc_update

FIX: Typos and style details