
<head></head><body><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">+1 to Tony’s naming suggestions, myself preferring move(index:by:), move(indexForward:), and move(indexBackward:) as it is the most clear and consistent.</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">As an aside, I am not a fan of the form- prefix, as it feels generic without being self explanatory. I think another word would work better. I won’t bikeshed, but I feel form- feels and reads oddly every time I see it.</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;"><br></p><font face="Nylas-Pro, Helvetica, Lucidia Grande, sans-serif"><span style="font-size: 14.5px; line-height: 21.75px;"><br></span></font><p></p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;"></p><p></p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;"><br></p><blockquote style="margin: 0 0 0 40px; border: none; padding: 0px;">&gt; On Apr 10, 2016, at 2:41 PM, Chris Lattner via swift-evolution &lt;<a href="mailto:swift-evolution@swift.org" title="mailto:swift-evolution@swift.org" style="color: rgb(16, 129, 247);">swift-evolution@swift.org</a>&gt; wrote:<br>&gt;&nbsp;<br>&gt; Hello Swift community,<br>&gt;&nbsp;<br>&gt; The review of "A New Model for Collections and Indices" begins now and runs through April 18th. The proposal is available here:<br>&gt;&nbsp;<br>&gt;&nbsp;<a href="https://github.com/apple/swift-evolution/blob/master/proposals/0065-collections-move-indices.md" title="https://github.com/apple/swift-evolution/blob/master/proposals/0065-collections-move-indices.md" style="color: rgb(16, 129, 247);">https://github.com/apple/swift-evolution/blob/master/proposals/0065-collections-move-indices.md<br></a>&gt;&nbsp;<br>&gt; Reviews are an important part of the Swift evolution process. All reviews should be sent to the swift-evolution mailing list at:<br>&gt;&nbsp;<a href="https://lists.swift.org/mailman/listinfo/swift-evolution" title="https://lists.swift.org/mailman/listinfo/swift-evolution" style="color: rgb(16, 129, 247);">https://lists.swift.org/mailman/listinfo/swift-evolution<br></a>&gt; or, if you would like to keep your feedback private, directly to the review manager.<br>&gt;&nbsp;<br>&gt;&nbsp;<br>&gt; What goes into a review?<br>&gt;&nbsp;<br>&gt; The goal of the review process is to improve the proposal under review through constructive criticism and, eventually, determine the direction of Swift. When writing your review, here are some questions you might want to answer in your review:<br>&gt;&nbsp;<br>&gt; * What is your evaluation of the proposal?<p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">I agree with the general direction and scope of the proposal, but I think the names could use some changes. Specifically, I don’t think the fallback to ‘form’ is required. It would be a significant readability improvement to use a meaningful verb to describe the action of altering the argument. The methods that create new indices probably need a label on the first argument, because otherwise it looks as if the IndexDistance is what is described by ‘index’.</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Proposed:</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func successor(of i: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func formSuccessor(i: inout Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Instead, I suggest:</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func successor(of i : Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func advance(i: inout Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Proposed:</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func index(n: IndexDistance, stepsFrom i: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func index(n: IndexDistance, stepsFrom i: Index, limitedBy limit: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func formIndex(n: IndexDistance, stepsFrom i: inout Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func formIndex(n: IndexDistance, stepsFrom i: inout Index, limitedBy limit: Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Suggested (taking into account Nate’s suggestion of reversing the order):</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func index(startingAt i: Index, movedBy n: IndexDistance) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func index(startingAt i: Index, movedBy n: IndexDistance, limitedBy limit: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func move(i : inout Index, by n: IndexDistance)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func move(i : inout Index, by n: IndexDistance, limitedBy limit: Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Proposed:</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func predecessor(of i: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func formPredecessor(i: inout Index)</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">Suggested:</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func predecessor(of i: Index) -&gt; Index</p><p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">&nbsp;&nbsp;func reverse(i: inout Index)</p><div><br></div>I think reversing an index has some nice symmetry with reversing a sequence, but if it seems to confusing, then replace advance and reverse with ‘moveForward’ and ‘moveBackward’.<p style="font-family: Nylas-Pro, Helvetica, 'Lucidia Grande', sans-serif; font-size: 14.5px; line-height: 21.75px;">- Tony</p></blockquote></body>