document the `2.5` validation options