updates docs in environment_helpers.rb to be in yard format

## motivation

The existing docs where in rdoc format and exposed some private APIs.