[swift-evolution] Proposal: Update the API Design Guidelines to reflect current Standard Library method naming conventions

Chris Lattner clattner at apple.com
Sun Dec 6 17:03:32 CST 2015

> On Dec 6, 2015, at 6:40 AM, Daniel Steinberg via swift-evolution <swift-evolution at swift.org> wrote:
> I love that the team has released API Design Guidelines and find them very helpful. One piece of advice, however, seems to be at odds with current Standard Library practice.
> Currently the methods sort() and sortInPlace() are the non-mutating and mutating versions of sorting a collection. Similarly, there are pairs of methods in Set named union() and unionInPlace(), intersect() and intersectInPlace() and so on.

Hi Daniel,

This is a known issue, and it is because we want to keep Swift 2.2 reasonable source compatible with Swift 2.  The changes to the standard library will land after Swift 2.2 branches for its release in the spring.  

If you’re interested in more details on this effort, check out this blog post:
https://swift.org/blog/swift-3-api-design/ <https://swift.org/blog/swift-3-api-design/>

It includes a link to the diff-in-progress for the standard library.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-evolution/attachments/20151206/8961cb30/attachment.html>

More information about the swift-evolution mailing list