Improving JavaDoc
Fix after review of the validation API chapter