[Reference] document the `2.5` validation options

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.5+
| Fixed tickets | part of #4094
let's see if we get a response on 12975, but I'm reading the code in that PR the same as you are.