Add missing docs for soft_write_failure for master/agent setup

We had added the feature for soft_write_failure in 1.5.x, but the documentation
was only updated for puppet apply cases. This patches updates the documentation
for puppet master/agent setups as well.

Signed-off-by: Ken Barber <ken@bob.sh>
Validate against strings not keywords
Fix precondition in `validate-order-by!`
Resources query paging tests
Sort results during post-processing
Docstrings and conditions for sorting functions
Generalize the ordering functions for sorting the resources
Move `order-by` and related functions over to `utils` namespace
Add tests for `order-by`
Change `:field` entries in order-by maps from strings to keywords
Use simplified `order-by` expression data structure

Prior to this commit, we were using two different data structures
to represent an 'order-by' term.

We also weren't validating the ascending/descending portion of
an order-by term in the HTTP middleware; we were putting that
off all the way until the jdbc code, and passing around these
potentially varying string representations everywhere else
throughout the code.

This commit moves the validation logic for the 'order' terms back
into the HTTP middleware.  From that point on, we can be assured
that the 'order' will be represented as either `:ascending` or
`:descending`, and all of the order-by terms will be valid
based on the `order-by-expr?` predicate that goes along with
the new `order-by` utility function.
Docs: Update puppet apply instructions to not break puppet resource

Setting the storeconfigs settings in puppet.conf without modifying routes.yaml
will cause puppet resource to break on puppet apply nodes.
Docs: Mention reporting settings in puppet apply page
Fix pre-condition to accept type used at runtime
Fix tests for error handling on order-by 'order' value
Merge pull request #698 from nfagerlund/15_apply

Docs: Update puppet apply instructions to not break puppet resource
Merge pull request #697 from kbarber/maint/1.5.x/soft_write_failure_docs_missing

Add missing docs for soft_write_failure for master/agent setup
Note about "cannot assign requested address" error.
It is a FAQ. :)
Fixing markdown formatting.