From 0108071e760a391ac59a2e836c8085d165d079a0 Mon Sep 17 00:00:00 2001
From: syl20bnr <sylvain.benner@gmail.com>
Date: Sat, 6 Dec 2014 01:31:56 -0500
Subject: [PATCH] Add a section for shells in documentation

---
 DOCUMENTATION.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index 8416449b0..de8f876e9 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -68,6 +68,7 @@
         - [Ido](#ido)
             - [Experimental Ido feature](#experimental-ido-feature)
         - [NeoTree file tree](#neotree-file-tree)
+        - [Shells](#shells)
         - [Bookmarks](#bookmarks)
     - [Searching](#searching)
         - [Project Searching](#project-searching)
@@ -118,6 +119,7 @@
     - [Tips for Spacemacs advanced users](#tips-for-spacemacs-advanced-users)
         - [evil-lisp-state as default state](#evil-lisp-state-as-default-state)
         - ["jk" to trigger evil leader](#jk-to-trigger-evil-leader)
+        - [Smooth fonts on Windows](#smooth-fonts-on-windows)
 - [Achievements](#achievements)
 - [Thank you](#thank-you)
 
@@ -1058,6 +1060,17 @@ Key Binding                      |                 Description
 <kbd>q</kbd> or <kbd>fd</kbd>    | hide `NeoTree` buffer
 <kbd>r</kbd>                     | rename a node
 
+### Shells
+
+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.
+
+There are two solutions for this:
+- use <kbd>C-o</kbd> then use the leader key
+- enable the [leader on `jk`](#experimental-insert-state-feature)
+experimental feature.
+
 ### Bookmarks
 
 Bookmarks can be set anywhere in a file. Bookmarks are persistent. They are very