Please add a description of rotating adjacent selections to the tutorial and documentation

[akhilman]

There is a cool feature not mentioned anywhere in the documentation or tutorial, but well explained in Helix Golf — rotating adjacent selections.
For example we have a map:

a = A
b = B
c = C

We doing %<A-s>S=<Enter>_2<A-)>
And getting:

A = a
B = b
C = c

Please add a mention of this feature to the documentation and include an "Invert Dictionary" example in the tutorial, so that new users can discover and learn about this amazing feature.

[pratikrath126]

You're right that rotating selections is a gem! It's essentially applying the same transformation to each selection in order. The sequence is:

1. Create multiple cursors (via space then t selection modes or regex matches)
2. Apply a change with s (substitute), c (change), etc.
3. Use Alt+Right Paren to rotate to the next selection and repeat

Your dictionary invert example works because each cursored key/value pair gets the same substitution pattern with only the current selection active. The _2 reference means the text two lines ahead relative to each selection point.

Other patterns:

• Renaming variables: %old/new<A-)>
• Wrapping items: %i{<A-)>
• Incrementing numbers: %="+1<A-)>

It's under-documented and worth a tutorial section—multi-cursor iteration makes Helix powerful for bulk edits.