<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Feb 20, 2016, at 13:26, Charles Kissinger via swift-evolution <<a href="mailto:swift-evolution@swift.org" class="">swift-evolution@swift.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html charset=utf-8" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div class=""><blockquote type="cite" class=""><div class="">On Feb 19, 2016, at 5:20 PM, Craig Cruden <<a href="mailto:ccruden@novafore.com" class="">ccruden@novafore.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html charset=utf-8" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div class="">Neither really feel right - I am not against long names, but sometimes people have long names because they are unfocused and the API to a class/type has too many unfocused methods on it. Then it gets applied to other classes/types with less methods since it is more consistent with the naming of the class/types that they have already completed. </div><div class=""><br class=""></div><div class="">Whereas “ing”/“ed” is against all the naming conventions (closer to opposite of what was acceptable) of any development environment I have worked in the last 30 years.</div></div></div></blockquote><div class=""><br class=""></div><div class="">Hi Craig,<br class=""><br class="">I just haven’t been able to come up with a convention that meets Dave’s requirements and is consistently better. The best “-ing” alternative to my eye is “with-":<br class=""><br class="">s.expandTilde() // mutating<br class="">let t = s.withExpandedTilde() // non-mutating<br class=""><br class="">x.append(y)<br class="">let z = x.withAppended(y) // Meh<br class=""><br class="">a.trim(.whitespaceAndNewlines)<br class="">let b = a.withTrimmed(.whitespaceAndNewlines)<br class=""></div></div></div></div></blockquote></div><br class=""><div class="">I'll second that. "a.withTrimmed(.whitespaceAndNewlines)" makes no sense to me, i.e. the name "withTrimmed" is <i class="">hurting</i> comprehension. I tried to figure out <i class="">why</i> this is and eventually decided my brain was grouping it as "a with [trimmed whitespace]", as if "trimmed whitespace" were a thing. "havingTrimmed" would have been okay (a participle form), but feels clunky.</div><div class=""><br class=""></div><div class="">In case it's been lost in all the discussion, the -ing/-ed rule is essentially the rule Objective-C uses, minus the noun labels for the return value and types and the word "by". It's definitely very different grammatically from most other API guidelines, but so are Objective-C's guidelines.</div><div class=""><br class=""></div><div class="">Jordan</div><div class=""><br class=""></div><div class=""><br class=""></div></body></html>