-
-
Notifications
You must be signed in to change notification settings - Fork 2.5k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add tutor entry about 2-character label jump #11273
Conversation
while I love the jump mode I don't consider it a part of the core editor primitives. I think we should consider keeping the tutor lean and instead moving documentation for more advanced features to a |
If there is consensus on this then this is fine to me naturally :) . However, as a new user a few months ago, I found that the tutor is very effective as it gives good examples and a curriculum to follow / exercises to train muscle memory. I also felt that it was much easier for me to discover features by following the tutor compared to reading the manual which was a bit overwhelming / dry in my taste (I think the doc / manual is better suited as a lookup for people who already know more or less what exists :) ). So I would have liked to have this in the tutor. But it may just be my personal taste. |
Would moving this lower down in the tutor, to a short new "advanced motion" section, be ok for you - then it does not overwhelm the beginner early on in the tutor, but it is still taught? |
Or do you mean that we should have both |
I see this kind of thing fitting in with #997. I hope we can merge this in the near future and move a lot of docs there. Maybe an advanced section of the tutor also makes sense (to give users an idea what features even exist). What do you think @the-mikedavis |
I think it would definitely be very beneficial to expose people to some concepts as early as possible, even if its not considered a "core" of helix. Some of these "extras" could offer a foundational change to someone interacting with their editor. Adding an advanced section to the tutor would open up an area to expose workflows that could offer similar opportunities. |
To add on what you write: I heard about gw because I accidentally landed on a release description page mentioning it - otherwise I would have missed it. It would have been very helpful for me a few months ago to go through it once in the tutor to discover it earlier :) . |
Yeah I imagine |
If I get green light to put this into the tutor I can easily move it to section 9 or keep it where it is when you let me know what final decision is made :) . I would love to keep this in the tutor, but if it is declined I can move into |
I think moving it to section 9 and merging is fine for now. We can always reorganize the tutor later (or move it to :help) |
Done moving the gw tutor to chapter 9 :) . |
* Add tutor entry about 2-character label jump * Move gw tutor to chapter 9 * Do not explicitely say which labels are shown following gw
* Add tutor entry about 2-character label jump * Move gw tutor to chapter 9 * Do not explicitely say which labels are shown following gw
* Add tutor entry about 2-character label jump * Move gw tutor to chapter 9 * Do not explicitely say which labels are shown following gw
* Add tutor entry about 2-character label jump * Move gw tutor to chapter 9 * Do not explicitely say which labels are shown following gw
What's preventing #997 from being merged? |
It just needs another round of review. It's been sitting in my 'todo' queue for way too long, I'll take a look at it again this morning |
* Add tutor entry about 2-character label jump * Move gw tutor to chapter 9 * Do not explicitely say which labels are shown following gw
This is just a simple addition to the tutor file to document the
gw
2-character label jump motion.