Refactoring docs about environment

Closes #818
Added with  8e73483 and  34567ea.