I think most other projects here use the style `:environment` for parameters in their api docs. We should probably consider switching to that. @nfagerlund weigh in?