docs: update readme

Author: pemrouz

README.md

@@ -2,7 +2,7 @@
 [![Coverage Status](https://coveralls.io/repos/rijs/hypermedia/badge.svg?branch=master&service=github)](https://coveralls.io/github/rijs/hypermedia?branch=master)
 [![Build Status](https://travis-ci.org/rijs/hypermedia.svg)](https://travis-ci.org/rijs/hypermedia)
 
-Enhances Ripple to be able to register subresources, traverse links in responses and cache them.
+Extends [core](https://github.com/rijs/core#ripple--core) to register a HATEOAS API as a resource, traverse links to other resources, and cache them.
 
 Normally, you can register some array/object/function/whatever against a key:
 
@@ -27,13 +27,13 @@ ripple('github.current_user_url.repos_url.0.owner.login')
 
 If it hits a property whose value is a URL (in the GitHub API, all those suffixed with `*_url`), it resolves and caches them as an intermediate resource. So accessing `ripple('github.current_user_url.id')`, would also populate the resource `ripple('github.current_user_url')`.
 
-You can pass any extra headers you want (in this case, basic auth) to be used in the request by setting the `http` header.
+You can pass any extra headers you want (in this case, basic auth) to be used in the request by setting the `http` header (accessing subresource will automatically inherit headers). 
 
 ```js
 ripple('github', 'https://api.github.com', { http })
 ```
 
-You expand parameterised routes and also alias resources:
+You can expand parameterised routes and also alias resources:
 
 ```js
 ripple('repo', { owner: 'pemrouz', repo: 'ripple' }, { link: 'github.repository_url' })
@@ -50,4 +50,4 @@ ripple('issue', { owner: 'pemrouz', repo: 'ripple', number: 1 }, { link: 'github
 * [ ] Add profiles for dot notation to be able to traverse other hypermedia formats (HTML, HAL, Siren, Collection, etc) - see [Jon Moore's presentation](http://www.infoq.com/presentations/web-api-html) for HTML example.
 * [ ] Test use in declarative usage `<visualise-repos data="github.repos">` 
 * [ ] Alias subresources `ripple('repos', 'github.current_user_url.repos_url')`
-* [ ] Use same syntax to `POST` messages back: `ripple('github.current_user_url.repos_url', { new repo details })`
+* [ ] Use same syntax to `POST` messages back: `ripple('github.current_user_url.repos_url', { body: new repo details })`