Merge branch 'documentation-improvements' into 'master'

Re-organize README, split off contribution guide

This pull request is a starting point for improving the documentation prior to the upcoming brownbag.

Starting with the README and contribution guide, I'll be poring over the existing docs trying to come up with examples. I'm thinking the wiki here in git.doit will be helpful as well.

See merge request !4