update docs with new validation rules