Similarly to what is usually done in Hibernate Validator and Hibernate ORM.

We currently use javadoc annotations (@hsearch.experimental). Let's drop these and use an actual annotation instead (meta-annotated with @Documented).