That would be an excellent idea! Are you volunteering to write it up?
So right now we have:
-
Sequence.sorted()
,.sorted(by:)
,MutableCollection.sort()
, .sort(by:)
should document that the sort algorithm is stable. (Starting from Swift x.y) -
Set.union(_:)
,Set.intersection(_:)
, andSet.formIntersection(_:)
(all overloads) should document that members of the result that appear in both inputs are taken fromself
. (Interestingly,formUnion
already has this guarantee.) (Starting from Swift 5.6)
Anything else?