Small README overhaul

I modified `REDAME.md`
* to fix a typo
* to add some anchor links to facilitate the navigation in the same document
promise streams are accepted here as well, as defined in the section describing bodies. will need to follow-up to clarify that.