documentation improvements

some basic restructuring
This is removed code, but I added the line to the new file `docs/development_environment.md`