HSEARCH-1340 adding a explicit 'Setting the facet sort order' section
HSEARCH-1342 Unrelated javadoc fix