update readme
update readme

- housekeeping: proper formatting for headings, content and code, fix typos, order document content better, remove redundant content
- links: fix broken internal links in api section
LivePersonInc/batchelor