Improve documentation on validations