Evil for Emacs users

[Vegard Øye]

On 2012-02-20 21:19 +0100, Leo Alekseyev wrote:

> http://dnquark.com/blog/2012/02/emacs-evil-ecumenicalism/

Interesting blog post! It highlights some areas in which the current
documentation is rather lacking -- it's been neglected for some time
now ...

I've recently been looking to Frank's User Guide for vim-mode as a
guide to improving Evil's documentation.[1] What is really needed
-- and both your blog post and Frank's guide underline this -- is
an overview of the different states and how they relate to Emacs'
keymap hierarchy. Rebinding keys and configuring the initial state
should also be dealt with in more detail, with instructive examples.

Furthermore, maybe the "Settings" chapter should be moved to the end,
since it might be a bit overwhelming up-front. (On the topic of
settings, we could perhaps add an `evil-want-sparse-insert-state'
customization variable for disabling most of the key bindings of
Insert state.)

[1] http://www.emacswiki.org/emacs/VimMode_-_User%27s_Guide

-- 
Vegard