[swift-evolution] [Guidelines, First Argument Labels]: Prepositions inside the parens
dabrahams at apple.com
Thu Feb 11 13:57:40 CST 2016
on Thu Feb 11 2016, Douglas Gregor <dgregor-AT-apple.com> wrote:
>> 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!
Hmm, looking at these I think it's really the “lonely ‘of’” that we want
to pull out of the parens, i.e.
More information about the swift-evolution