README should quickly answer "what does this solve"

[dbalatero]

Hi! As quick feedback, the README for this repo makes me want to close Chrome because it's not immediately obvious what this plugin does.

You might want to take another read, but pretend you've never heard of the plugin before.

The repository you link out to (https://github.com/jdhao/better-escape.vim) has a better introduction:

A lot of people have been mapping jk or kj or kk to ESC in order to escape insert mode quickly. However, when we press the first key in these mappings, Vim/Nvim will wait for timeoutlen milliseconds before writing this char to buffer. The apparent lag caused by this behaviour is annoying.

Better-escape.vim is created to help Vim/Nvim users escape insert mode quickly using their customized key combinations, without experiencing the lag.

You should have something like that front and center on this project's README. If don't immediately understand a plugin's purpose when browsing the repo, I will often just close the tab and move on. Get people excited about it!

[dbalatero]

Better-escape.vim is created to help Vim/Nvim users escape insert mode quickly using their customized key combinations, without experiencing the lag.

I wish the vim version of this plugin explained a bit how it worked too, maybe you could add that as well?

[max397574]

thanks for the feedback
heard that already.
I'm working on it

[max397574]

Added it to the readme.

[dbalatero]

Awesome, this looks great!

There's a little bug–it looks like the GIF you added to the README got converted to a PNG somehow, so it's not animating. You might need to reupload/readd it :)

[dbalatero]

Also you've convinced me to install it now :)

[max397574]

This is just a picture
The gifs are below (demo)
This just shows the moment

[max397574]

ig I should add links