HSEARCH-1644

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

> Because I needed to switch to more urgent topics. If you don't accept incremental improvements, you're opting for no improvements.

You are making some changes not anyways. I don't see how making a change in this paragraph is any different from any other change. But, whatever...