Rewrote readme for improve consistency and cohesion

- Added top-level navigation
- Added 'report an issue' section
- Updated code examples to use latest APIs