Rewrote readme for improve consistency and cohesion

- Added top-level navigation
- Added 'report an issue' section
- Updated code examples to use latest APIs
Moving resources section below all code sections.