HSEARCH-1644

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

> I'm not sure either. I agree the explanation gets off-topic from the main point which is to get Hibernate Search running. Could we keep it as separate JIRA?

Why? You are adding it now, so I think we should also discuss this now.

> I also would like to start the first chapter with a "what prolems does this solve" introduction 

Is this not already in the preface? Not quite sure where you want to put that.