Environment documentation

Clarify how r10k works with dynamic environments and how to test using an environment.
Correct capitalization of r10k in a few places.
The existing documentation is ambiguous on how Git branches map to Puppet environments, but I don't think this makes it any clearer.