299 doc restructure

Here's my first stab at this.

The idea is to trim the main README down to "everything you need to know in 5 minutes", and then break out the rest into topic documents.
This sentence seems odd: _One of the core features is versioning. While it's debatable if this feature is indeed a pure REST, we believe it's a best practice one_

Maybe better:
_One of the core features is versioning. Not providing versioning for your API is almost the same as acknowledging that your API only supports one single consumer. The versions are at the resource level, for more flexibility and control._