Refactoring docs about environment

Closes #818