HSEARCH-1644

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

Great. I've been trying to slim down, especially considering its the intro chapter. details and clarifications should be explored further down.