HSEARCH-1644

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

Good point, that would improve the flow, but also sounds like I should add 4 example code snippets?