README improvements
Created by: myronmarston
My main goal here was to add a section on scope. After reading http://therealadam.com/2015/03/01/its-not-your-fault-if-your-tools-confuse-you/ I realized we don't document scope very well. While reading through what we had in the README I noticed a number of things that could be improved so I went ahead and addressed those.