HSEARCH-1342 formatting
HSEARCH-1342 Adding an 'Interpreting a Facet result' section
HSEARCH-1340 Adding an explicit 'Setting the facet sort order' section
HSEARCH-1342 Unrelated javadoc fix
HSEARCH-1342 Some typos and clarifications
HSEARCH-1342 Be consistent with punctuation in lists
HSEARCH-1340 Promote the Faceting Sort section paragraph to an higher level