[swift-evolution] [Review] SE-0023 API Design Guidelines

Thorsten Seitz tseitz42 at icloud.com
Mon Jan 25 23:59:15 CST 2016


Am 25.01.2016 um 04:07 schrieb Dave Abrahams via swift-evolution <swift-evolution at swift.org>:

>> "The use of external parameter names can allow a function to be called
>> in an expressive, sentence-like manner, while still providing a
>> function body that is readable and clear in intent."
>> 
>> Source:
>> https://developer.apple.com/library/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Functions.html
>> 
>> That's the 2.1 guide, so your mileage may vary in 3.0, but that's some
>> of the baggage coming in to this review.
> 
> Understood; the "sentence-like" idea keeps getting repeated.  The
> keepers of Cocoa APIs tell me that, since several years ago, they moved
> away from adding prepositions to secondary selector pieces to make
> things more sentence-like.

IMO being able to make signatures read more sentence-like is a real advantage of Smalltalk, Objective-C and now Swift with its external labels over other languages, so it's a bit sad to hear that.

-Thorsten


More information about the swift-evolution mailing list