Better documentation for validation states