Documentation refresh

- Stripped down the core README.md to contain only a pointer to the real docs, so you don't have to maintain docs outside of Jekyll.
- Reformatted the intro into multiple sections.
- Reorganized and compressed sections in the detailed usage guide.

Hope this helps!

By the way, sat in for your Effective SBT talk @ ScalaDays last month - great pointers!