<div dir="ltr">Question about how to interpret/apply the guidelines:<div><br></div><div> "[functions/methods] without side-effects should read as noun phrases…"</div><div> "Use the “ed/ing” rule to name the nonmutating counterpart of a mutating method…"</div><div> "The names of other types, properties, variables, and constants should read as nouns."<br></div><div><br></div><div>Within these guidelines, how do we explain why <b>-stringByExpandingTildeInPath</b> becomes "var <b>expandingTildeInPath</b>"? I'm wondering if the guidelines should clarify that the "ed/ing rule" may apply to more than just nonmutating methods with mutating counterparts.</div><div><br></div><div>I think that "var expandingTildeInPath" is probably the best choice for this API, but I can't figure out how to reconcile it with the guidelines as written.</div><div class="gmail_extra"><br clear="all"><div><div><div dir="ltr"><div>Jacob<br></div></div></div></div>
<br><div class="gmail_quote">On Wed, Feb 17, 2016 at 11:55 AM, Dave Abrahams via swift-evolution <span dir="ltr"><<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span><br>
on Wed Feb 17 2016, Trent Nadeau <<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>> wrote:<br>
<br>
> I saw that that Markdown file wasn't on master so I didn't think a PR was<br>
> appropriate. I just looked, and it appears that gh-pages is the only branch<br>
> there.<br>
<br>
</span>Nothing wrong with that; you can submit a PR against any branch.<br>
<div><div><br>
> On Wed, Feb 17, 2016 at 1:01 PM, Dave Abrahams via swift-evolution <<br>
> <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>> wrote:<br>
><br>
>><br>
>> on Tue Feb 16 2016, Trent Nadeau <<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>> wrote:<br>
>><br>
>> > I like.<br>
>> ><br>
>> > Minor grammar fix: Remove the comma in "declared only once, but used<br>
>> > repeatedly" in the first rule.<br>
>><br>
>> Thanks!<br>
>><br>
>> FYI, for the future, pull requests work great :-)<br>
>><br>
>> > On Tue, Feb 16, 2016 at 9:31 PM, Dave Abrahams via swift-evolution <<br>
>> > <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>> wrote:<br>
>> ><br>
>> >><br>
>> >> I've updated the API guidelines document to account for the review<br>
>> >> feedback and other issues. Please see<br>
>> >> <a href="http://apple.github.io/swift-internals/api-design-guidelines/" rel="noreferrer" target="_blank">http://apple.github.io/swift-internals/api-design-guidelines/</a><br>
>> >> (presentation view)<br>
>> >> and<br>
>> >><br>
>> >><br>
>> <a href="https://github.com/apple/swift-internals/blob/gh-pages/api-design-guidelines/index.md" rel="noreferrer" target="_blank">https://github.com/apple/swift-internals/blob/gh-pages/api-design-guidelines/index.md</a><br>
>> >> (source and commit history)<br>
>> >><br>
>> >> --<br>
>> >> -Dave<br>
>> >><br>
>> >> _______________________________________________<br>
>> >> swift-evolution mailing list<br>
>> >> <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
>> >> <a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
>> >><br>
>><br>
>> --<br>
>> -Dave<br>
>><br>
>> _______________________________________________<br>
>> swift-evolution mailing list<br>
>> <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
>> <a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
>><br>
<br>
--<br>
-Dave<br>
<br>
_______________________________________________<br>
swift-evolution mailing list<br>
<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
<a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
</div></div></blockquote></div><br></div></div>