add environment documentation and recommendations