<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi all,<div class=""><br class=""></div><div class="">One of the major goals of Swift 3 is to introduce a set of API Design Guidelines for Swift and to apply those guidelines to both the Standard Library APIs and to imported (Objective-)C APIs. This initiative is described in more detail in the blog entry at</div><div class=""><br class=""></div><div class=""><span class="Apple-tab-span" style="white-space: pre;"> </span><a href="https://swift.org/blog/swift-3-api-design/" class="">https://swift.org/blog/swift-3-api-design/</a></div><div class=""><br class=""></div><div class="">We are going to initiate a public review of this work starting next Wednesday (January 20th) and running through the end of the month. The scale of the effort is far larger than anything else we’ve handled in the evolution process, comprising three related pieces:</div><div class=""><br class=""></div><div class=""><span class="Apple-tab-span" style="white-space: pre;"> </span>* API Design Guidelines: <a href="https://swift.org/documentation/api-design-guidelines.html" class="">https://swift.org/documentation/api-design-guidelines.html</a> (TODO: create a skeleton proposal in swift-evolution to link to)</div><div class=""><span class="Apple-tab-span" style="white-space: pre;"> </span>* Standard library API changes: <a href="https://github.com/apple/swift-evolution/blob/master/proposals/0006-apply-api-guidelines-to-the-standard-library.md" class="">https://github.com/apple/swift-evolution/blob/master/proposals/0006-apply-api-guidelines-to-the-standard-library.md</a></div><div class=""><span class="Apple-tab-span" style="white-space: pre;"> </span>* Clang importer changes: <a href="https://github.com/apple/swift-evolution/blob/master/proposals/0005-objective-c-name-translation.md" class="">https://github.com/apple/swift-evolution/blob/master/proposals/0005-objective-c-name-translation.md</a></div><div class=""><br class=""></div><div class="">We’ll handle this as three separate reviews (one per document) running concurrently. The concurrency is important because there is a lot of interplay between the different moving parts (e.g., an API change in the standard library will correspond to a particular guideline, or an importer rule implements a particular guideline, etc.). Yet, there is likely to be specific per-document feedback, and we benefit from having separate discussion threads.</div><div class=""><br class=""></div><div class="">We’re still getting all of the pieces together for the review, and these documents will change up until the public review period begins. Feel free to browse through the documents and the other references mentioned in the blog. However, we request that everyone hold off on discussion of the documents until the public review begins, so that we’re all talking about the exact same documents, and that you familiarize yourself with all three documents before participating in the public review of any of them (because they are so closely linked).</div><div class=""><br class=""></div><div class=""><span class="Apple-tab-span" style="white-space:pre"> </span>Cheers,</div><div class=""><span class="Apple-tab-span" style="white-space: pre;"> </span>Doug</div></body></html>