HSEARCH-1644

Docs updates ! :-)
 - https://hibernate.atlassian.net/browse/HSEARCH-1644

should we not use the +@Entity+, +@Id+, +@OneToMany+ - trying to get back the code highlighting