Improvements to documentation

This is a working branch to improve the documentation for the environment.

/cc @elstamey