docs: add @remarks to EnvironmentManager interface documenting when each method is called

docs: add @remarks to EnvironmentManager interface documenting when each method is called #1796