HSEARCH-1644

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

I find this very un-natural to read and as said, it is not what we agreed upon.