HSEARCH-1644

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

Ok, adding a layer.. good point.
I liked the note idea more but I don't see how I can stuff all that information and XML examples in a note.. that's what I meant I'd prefer to explore in a second time.