[swift-evolution] [Guidelines, First Argument Labels]: Prepositions inside the parens
Douglas Gregor
dgregor at apple.com
Thu Feb 11 13:35:40 CST 2016
> On Feb 11, 2016, at 10:53 AM, Dave Abrahams via swift-evolution <swift-evolution at swift.org> wrote:
>
>
> on Thu Feb 11 2016, Charles Kissinger <swift-evolution at swift.org> wrote:
>
>> FWIW, I think these new guidelines strike a very nice balance between
>> all of the competing concerns. The result of applying them to some of
>> my own code could best be described as “different but not unpleasant”
>> ;-)
>>
>> In looking over the diffs, one nice result I didn’t expect is that
>> moving the prepositional phrases into the first argument label seems
>> to increase the speed with which I absorb the general intent of a
>> function -- the “at a glance” understanding -- by moving a “detail”
>> (important as it might be) into the parameter list. (The split
>> prepositional phrases had the opposite effect for me.)
>
> That's nice! What do you think about moving “of” back out of the
> parens? Does that help or hurt?
And lo!, a diff appeared!
https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f
- Doug
More information about the swift-evolution
mailing list