<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div><br>Hi all,</div><div><br></div><div>I could get used to the form<i>Noun</i> naming convention for the mutable versions of the methods. </div><div><br></div><div>I would suggest the following changes:</div><div><br></div><div>Remove the parameter label from symmetricDifference() and formSymmetricDifference() to be consistent with the other methods. </div><div><br></div><div>Consider renaming:</div><div>subtracting / subtract </div><div><br></div><div>to: </div><div>difference / formDifference</div><div><br></div><div>in order to keep the API consistent. </div><div><br><div>Thanks<br><br></div>On Mar 24, 2016, at 5:35 PM, Xiaodi Wu via swift-evolution <<a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a>> wrote:<br><br></div><blockquote type="cite"><div><div style="white-space:pre-wrap">Much improved, IMO. A few thoughts:<br>* typo in "formSymmetricDifference"<br>* I don't know about the preposition "from" in "form symmetric difference from" (also, inconsistent, because you don't have "form union with")<br>* "form" is fine, but scans similarly to "from" when reading quickly<br></div><br><div class="gmail_quote"><div dir="ltr">On Thu, Mar 24, 2016 at 3:41 PM Dave Abrahams via swift-evolution <<a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
Just an update:<br>
<br>
The naming guidelines working group went back into negotiation over<br>
the shape of SetAlgebra (and thus, Set and OptionSet) for<br>
Swift 3, and reached a new consensus. We intend to bring forward a<br>
proposal for the API shown here:<br>
<br>
<a href="http://dabrahams.github.io/swift-naming/SetAlgebra-Math.html" rel="noreferrer" target="_blank">http://dabrahams.github.io/swift-naming/SetAlgebra-Math.html</a><br>
<br>
and to update the guidelines to suggest using the "form" prefix to<br>
create a verb phrase for a mutating method when the operation is<br>
fundamentally non-mutating and described by a noun.<br>
<br>
Regards,<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>
</blockquote></div>
</div></blockquote><blockquote type="cite"><div><span>_______________________________________________</span><br><span>swift-evolution mailing list</span><br><span><a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a></span><br><span><a href="https://lists.swift.org/mailman/listinfo/swift-evolution">https://lists.swift.org/mailman/listinfo/swift-evolution</a></span><br></div></blockquote></body></html>