Updated sort docs.  Note that this just corrects the information,
but the docs themselves still should be substantially updated to
reflect the updated sorting framework.
Fix sort order in example, other minor sort doc updates.