Update sort-by and sort docstrings to indicate they will be stable sorts

Description

Clojure sort and sort-by both promise "Guaranteed to be stable: equal elements will not be reordered."

The current implementations of `sort` and `sort-by` in ClojureScript are from

core.cljs

Since this implementation has apparently called google's stableSort for the last 8 years perhaps the docstring could be amended to reflect this.

For reference, the google closure array documentation: https://google.github.io/closure-library/api/goog.array.html:

Note that stableSort's docstring actually doesn't mention stability but the sort function contains "This sort is not guaranteed to be stable."

Environment

Clojurescript 1.10.439 but I was unable to select in the "Affects Version/s" list

Assignee

Unassigned

Reporter

Daniel Sutton

Labels

Approval

None

Patch

None

Affects versions

Priority

Minor
Configure