Docs

Reviewed previous docs PR, now verified the rendered links and docbook-based PDF and HTML outputs.

 - https://hibernate.atlassian.net/browse/HSEARCH-1670
 - https://hibernate.atlassian.net/browse/HSEARCH-1671