<div dir="ltr">Question about how to interpret/apply the guidelines:<div><br></div><div>    &quot;[functions/methods] without side-effects should read as noun phrases…&quot;</div><div>    &quot;Use the “ed/ing” rule to name the nonmutating counterpart of a mutating method…&quot;</div><div>    &quot;The names of other types, properties, variables, and constants should read as nouns.&quot;<br></div><div><br></div><div>Within these guidelines, how do we explain why <b>-stringByExpandingTildeInPath</b> becomes &quot;var <b>expandingTildeInPath</b>&quot;? I&#39;m wondering if the guidelines should clarify that the &quot;ed/ing rule&quot; may apply to more than just nonmutating methods with mutating counterparts.</div><div><br></div><div>I think that &quot;var expandingTildeInPath&quot; is probably the best choice for this API, but I can&#39;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">&lt;<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt;</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 &lt;<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt; wrote:<br>
<br>
&gt; I saw that that Markdown file wasn&#39;t on master so I didn&#39;t think a PR was<br>
&gt; appropriate. I just looked, and it appears that gh-pages is the only branch<br>
&gt; there.<br>
<br>
</span>Nothing wrong with that; you can submit a PR against any branch.<br>
<div><div><br>
&gt; On Wed, Feb 17, 2016 at 1:01 PM, Dave Abrahams via swift-evolution &lt;<br>
&gt; <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt; wrote:<br>
&gt;<br>
&gt;&gt;<br>
&gt;&gt; on Tue Feb 16 2016, Trent Nadeau &lt;<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt; &gt; I like.<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt; Minor grammar fix: Remove the comma in &quot;declared only once, but used<br>
&gt;&gt; &gt; repeatedly&quot; in the first rule.<br>
&gt;&gt;<br>
&gt;&gt; Thanks!<br>
&gt;&gt;<br>
&gt;&gt; FYI, for the future, pull requests work great :-)<br>
&gt;&gt;<br>
&gt;&gt; &gt; On Tue, Feb 16, 2016 at 9:31 PM, Dave Abrahams via swift-evolution &lt;<br>
&gt;&gt; &gt; <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt; wrote:<br>
&gt;&gt; &gt;<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; I&#39;ve updated the API guidelines document to account for the review<br>
&gt;&gt; &gt;&gt; feedback and other issues.  Please see<br>
&gt;&gt; &gt;&gt; <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>
&gt;&gt; &gt;&gt; (presentation view)<br>
&gt;&gt; &gt;&gt; and<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; <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>
&gt;&gt; &gt;&gt; (source and commit history)<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; --<br>
&gt;&gt; &gt;&gt; -Dave<br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt; &gt;&gt; _______________________________________________<br>
&gt;&gt; &gt;&gt; swift-evolution mailing list<br>
&gt;&gt; &gt;&gt; <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
&gt;&gt; &gt;&gt; <a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
&gt;&gt; &gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; --<br>
&gt;&gt; -Dave<br>
&gt;&gt;<br>
&gt;&gt; _______________________________________________<br>
&gt;&gt; swift-evolution mailing list<br>
&gt;&gt; <a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br>
&gt;&gt; <a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
&gt;&gt;<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>