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.
Added docs section link to top nav, contribute section
- Fixed misc. typos & formatting issues
Merge pull request #419 from angular-ui/readme

README rewrite