[RFC] Nvim specific docs: Misc. improvements

Besides the items mentioned in the commit message, most of the rewritten portions were done for clarity and consistency, but much of that is of course subjective so feel free to criticize.
Lines 25-28 can be deleted.