Update docs for new environment changes and add a guide

Update docs for new environment changes and add a guide #1055