doc: how to update a shared pyenv virtualenv

[1fish2]

• Add docs/maintaining_the_sherlock_environment.md.
• Cross-links and minor updates in other docs.

@thalassemia let me know any additional questions to answer in this doc.