Cleanup README

* Make it look prettier in github
* Fix some API docs bugs