HSEARCH-1644

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

What are you up to here? Breaking up into one sentence per line? Why?