Update API documentation

* Some cosmetic changes like wrapping paragraphs
* Better usage example using python and PHP for JSONRPC

Signed-off-by: Vasudev Kamath <kamathvasudev@gmail.com>