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

[Dave Abrahams]

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?

-- 
-Dave