Refactoring docs about environment

Closes #818
Done