Create a friendlier and more helpful README
Improve README readability
Add hyperlinks
[readme] - respond to justin's comments. also add API change warning.
Merge pull request #1021 from palantir/readme-friendlier

Create a friendlier and more helpful README