[swift-evolution] [Guidelines, First Argument Labels]: Prepositions inside the parens

Dave Abrahams dabrahams at apple.com
Thu Feb 11 12:53:38 CST 2016

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?


More information about the swift-evolution mailing list