Refactor README a little

still lots of room for improvement if anybody has better suggestions for
organization/examples/setup/best-practices etc

Author: mattsta