Skip to content
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

vimtutor: Rethinking "Lesson 1.1: MOVING THE CURSOR" #5188

arp242 opened this issue Nov 7, 2019 · 3 comments


Copy link

@arp242 arp242 commented Nov 7, 2019

vimtutor is by far the best way to get started with Vim. I always recommend all new users run it. But there's one thing that has bugged me for years: the first lesson, which tells people to use hjkl instead of the arrow keys.

Is this really an important thing to tell users right at the start? Vim works fine with arrow keys, and all users already know how to use them. It takes quite a lot of effort and retraining of muscle memory to unlearn the arrow keys, and the cost/benefit ratio is not a good one.

I would say that everything below the first lesson is vastly more important than learning about hjkl. Motions like w and } will save people much more time; llllllllll and jjjjjjjj are just as bad as <Left><Left>.. and <Down><Down>..

I propose that this section be rewritten to encourage the user of the arrow keys, while still mentioning hjkl. I don't think it should be vimtutor's job to explain everything about Vim, but rather get people reasonably productive with just the basics, prioritizing on the most important issues. In that context, hjkl seems like a micro-optimisation to me; something to learn after you've already learned all the basics already.

There is already much to take in from vimtutor, and the more is added, the more chance there is people will forget about those more important commands.


This comment has been minimized.

Copy link

@brammool brammool commented Nov 9, 2019

Using "hjkl" is one of the core functions of Vi and Vim. Yes, it takes time to learn. But it pays back very quickly. I know no keyboard where I can reliably hit the cursor keys without looking at them. And moving a few lines or characters are the most often used commands.

@brammool brammool closed this Nov 9, 2019

This comment has been minimized.

Copy link

@arp242 arp242 commented Nov 11, 2019

I know no keyboard where I can reliably hit the cursor keys without looking at them

I don't think this is common among the kind of users who run vimtutor.


This comment has been minimized.

Copy link

@vim-ml vim-ml commented Nov 11, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
3 participants
You can’t perform that action at this time.