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.
Here are the bare essentials from one of the multiple examples from [the example module](./modules/restful_example):