Improves documentation for https://github.com/civicrm/civicrm-core/pull/25285
Also see dev!1046 (merged)