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,formUnionalready has this guarantee.) (Starting from Swift 5.6)
Anything else?