From a1e744b21813294d94cf6ddb89ef7442a12e8789 Mon Sep 17 00:00:00 2001
From: Sean Perry <shalehperry@gmail.com>
Date: Mon, 15 Apr 2024 12:23:11 -0700
Subject: [PATCH] Add Emacs switching guidance.

Mimiced from the Vim guidance.

Because there are now two of them, make an Editors  section.
---
 book/src/SUMMARY.md    |  4 +++-
 book/src/from-emacs.md | 17 +++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 book/src/from-emacs.md

diff --git a/book/src/SUMMARY.md b/book/src/SUMMARY.md
index ba330cf77..c7d85d73d 100644
--- a/book/src/SUMMARY.md
+++ b/book/src/SUMMARY.md
@@ -7,7 +7,9 @@
   - [Keymap](./keymap.md)
   - [Commands](./commands.md)
   - [Language support](./lang-support.md)
-- [Migrating from Vim](./from-vim.md)
+- [Migrating from other editors]
+  - [Vim](./from-vim.md)
+  - [Emacs](./from-emacs.md)
 - [Configuration](./configuration.md)
   - [Themes](./themes.md)
   - [Key remapping](./remapping.md)
diff --git a/book/src/from-emacs.md b/book/src/from-emacs.md
new file mode 100644
index 000000000..499106fe3
--- /dev/null
+++ b/book/src/from-emacs.md
@@ -0,0 +1,17 @@
+# Migrating from Emacs
+
+Helix is a modal editor stronly inspired by Vim and Kakoune. Users of doom Emacs
+will find it familiar. Helix follows the `selection → action` model. Where many Emacs
+commands can work with the item under point Helix will require a selection first.
+A cursor in Helix is simply a single width selection.
+
+Helix has buffers too. <space>-b will let you shift between them.
+
+Commands can be prefixed with numbers to change their behavior in much the same way
+as C-u N <command> does in Emacs.
+
+Registers in Helix work much like registers do in Emacs as well. Except there is
+currently no mark saving and moving. Check out the jumplist for an alternative.
+
+Many of the same behaviors from rectangle mark mode can be reproduced using multiple
+cursors.