Tidy up environments documentation (#17144)
Tidy up environments documentation (#17144)

Adds documentation requested in #17095, and also renames the `_environment` field to `environment`.
pantsbuild/pants,pantsbuild/pants,pantsbuild/pants,pantsbuild/pants,pantsbuild/pants,pantsbuild/pants,pantsbuild/pants