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

Jacob Bandes-Storch jtbandes at gmail.com
Thu Feb 11 15:44:09 CST 2016


We've lost consistency between "indexOf(_ object:)", "indexOfObjects(_
opts: passingTest:)" and "indexes(ofObjectsPassingTest:)".

Also, what about "lonely to"? Are folks okay with
"indexOfObjectIdentical(to: x)" ?

Jacob

On Thu, Feb 11, 2016 at 1:35 PM, Douglas Gregor via swift-evolution <
swift-evolution at swift.org> wrote:

>
> On Feb 11, 2016, at 11:57 AM, Dave Abrahams <dabrahams at apple.com> wrote:
>
>
> on Thu Feb 11 2016, Douglas Gregor <dgregor-AT-apple.com
> <http://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!
>
>
> https://github.com/apple/swift-3-api-guidelines-review/commit/3f965346f1edea804a9bc6223d2824f43687e92f
>
>
> Hmm, looking at these I think it's really the “lonely ‘of’” that we want
> to pull out of the parens, i.e.
>
>        indexOf(x)
>
> but not
>
>        animal(ofGenus: .reptile)
>
>
> Lonely “of”s move to the base name:
>
>
> https://github.com/apple/swift-3-api-guidelines-review/commit/f9cb1c468eee7cb827000911cad36e9e1b7fdfbc
>
> - Doug
>
>
> _______________________________________________
> swift-evolution mailing list
> swift-evolution at swift.org
> https://lists.swift.org/mailman/listinfo/swift-evolution
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-evolution/attachments/20160211/0fec3c8a/attachment.html>


More information about the swift-evolution mailing list