add docs for validator annotation