i think that the PR might still be the best documentation though, unfortunately: https://github.com/pantsbuild/pants/issues/5360