Updates for clarity

Using this version of the doc I was able to successfully
compile origin/master today. Hooray!