Anyone with an interest in the details of this docs addition:
A pull request is up for draft one of the change