Doc environment variables 593

fixes #593 
fixes #460 
I'd replace "your" and "our" with "the".