[Validator] Improved inline documentation of the violation builder