Refactor documentation out of README.md

[pralitp]

Think refactoring the documentation so it isn't all in the README.md and maybe instead put it in the Wiki of this repo. Then perhaps we should expand on the examples.