HSEARCH-1644

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

No I don't. This is just one of Emmanuel's posts. This is not hat we decided upon.