Refactoring docs about environment

Closes #818
Nope, because it is part of complete code.