HSEARCH-1644

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

but I'm happy to talk about it. Sorry I didn't mean to shut down the conversation.. just asking we run it at an appropriate place.