diff --git a/contrib/shell/README.md b/contrib/shell/README.md
index 4c5804d8e..84518ab65 100644
--- a/contrib/shell/README.md
+++ b/contrib/shell/README.md
@@ -89,6 +89,9 @@ Key Binding | Description
SPC a s e | Open, close or go to an `eshell`
SPC a s i | Open, close or go to a `shell`
SPC a s t | Open, close or go to a `term`
+SPC m h | browse history with `helm` (works in `eshell` and `shell`)
+C-j | next item in history
+C-k | previous item in history
**Note** You can open multiple shells using a numerical prefix argument,
for instance pressing 2 SPC ; will a second default shell, the
diff --git a/doc/DOCUMENTATION.md b/doc/DOCUMENTATION.md
index 718a16d03..a56ab2f2b 100644
--- a/doc/DOCUMENTATION.md
+++ b/doc/DOCUMENTATION.md
@@ -99,9 +99,6 @@
- [Opening files with NeoTree](#opening-files-with-neotree)
- [Other NeoTree key bindings](#other-neotree-key-bindings)
- [NeoTree mode-line](#neotree-mode-line)
- - [Shells](#shells)
- - [Key bindings](#key-bindings)
- - [Staying in insert state](#staying-in-insert-state)
- [Bookmarks](#bookmarks)
- [DocView mode](#docview-mode)
- [Searching](#searching)
@@ -1629,24 +1626,6 @@ The mode-line has the following format `[x/y] d (D:a, F:b)` where:
- `a` the number of directories in the current directory
- `b` the number of files in the current directory
-### Shells
-
-#### Key bindings
-
-Key Binding | Description
---------------------|----------------------------------------------------------------
-C-j | next item in history
-C-k | previous item in history
-SPC m h | browse history with `helm` (works in `eshell` and `shell`)
-
-#### Staying in insert state
-
-Navigating in shell buffers can be tricky because it is not possible to use the
-leader in `insert state`. Switching back and forth between normal and insert
-states can be tedious. The solution to this is to use C-o then use
-the leader key. C-o set the next key to be evaluated in
-`normal state`.
-
### Bookmarks
Bookmarks can be set anywhere in a file. Bookmarks are persistent. They are very