Only really the headless service docs on kubernetes:
https://kubernetes.io/docs/concepts/services-networking/service/#headless-services
The side effect of making this problem go away isn’t documented anywhere we could find. There are hints in recent changes to the code, but frankly, I don’t think I understand those changes.