[swift-evolution] [Review] SE-0006 Apply API Guidelines to the Standard Library

[Erica Sadun]

> On Jan 31, 2016, at 3:52 PM, Dave Abrahams via swift-evolution <swift-evolution at swift.org> wrote:
> 
> 
> on Sun Jan 31 2016, Erica Sadun <swift-evolution at swift.org <mailto:swift-evolution at swift.org>> wrote:
> 
>>> Canonical Dave:
>>>> Me:
>>>> - use nouns for unambiguously functional items without side effects (distanceTo(), successor)
>>>> - use verbs for unambiguously procedural items
>>> 
>>> This works great so far.  I think you can say
>>> 
>>> - use nouns for methods with no side effects (or only incidental ones,
>>>   like logging)
>>> - use verbs for methods with significant side-effects
>>> 
>>> and you can stop there.  Why does this have to be more complicated than
>>> that?
>>> 
>> 
>> Because *someone* put mutating/nonmutating rules into the
>> guidelines. 
> 
> Okay, guilty as charged already! :-)
> 
>> And I'm OCD enough that they are irritating me. It's the
>> mutating/nonmutating bits that I perceive as unneeded hungarianisms
>> that push a little too far into detailed advice by tying method naming
>> to overly specific fancy rules. (Insert a joke here about fancy cats
>> and fussy linguistic grooming.)
> 
> I'm saying, why don't we replace the mutating/nonmutating stuff with
> what I wrote above, and stop there?  Doesn't that fix the problem?

Why, yes. YES IT DOES.

That will do. That will do.

-- E, :)

> 
>>>> One final point: I think the -ed/-ing advice is wrong. Adding "ed"
>>>> isn't really creating a past tense verb (reversed). 
>>> 
>>> No, it's creating the past participle.  We had this checked by a
>>> linguist :-).
>> 
>> This is why I love you guys.
> 
> A benefit of working in a large company: an expert in <whatever> will
> pop out of the woodwork to correct your mistakes.
> 
> -- 
> -Dave
> 
> _______________________________________________
> swift-evolution mailing list
> swift-evolution at swift.org <mailto:swift-evolution at swift.org>
> https://lists.swift.org/mailman/listinfo/swift-evolution <https://lists.swift.org/mailman/listinfo/swift-evolution>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-evolution/attachments/20160131/201a804e/attachment.html>