added a note to the api documentation about JSON_SORT_KEYS. Fixes #922

See #922 for the conversation and rationale.