Clarify some documentation
Merge branch 'master' of github.com:snapframework/heist