@average-vr-56795: i put something in a comment that i probably should have put in a doc: https://github.com/pantsbuild/pants/pull/6095#issuecomment-404263176