Improved documentation about validators
Closes #5043