diff --git a/doc/delimitMate.txt b/doc/delimitMate.txt
index 58a33ef..6a1d2d8 100644
--- a/doc/delimitMate.txt
+++ b/doc/delimitMate.txt
@@ -51,9 +51,16 @@ Most of the features can be modified or disabled permanently, using global
 variables, or on a FileType basis, using autocommands. With a couple of
 exceptions and limitations, this features don't brake undo, redo or history.
 
-NOTE: If you have any trouble with this plugin, please run |:DelimitMateTest|
+NOTE 1: If you have any trouble with this plugin, please run |:DelimitMateTest|
 in a new buffer to see what is not working.
 
+NOTE 2: |'timeout'| needs to be set when working in the terminal, otherwise you
+might find weird behaviour with mappings including <Esc> or arrow keys.
+
+NOTE 3: Abbreiations set with |:iabbrev| will not be expanded by delimiters
+used on delimitMate, you should use <C-]> (read |i_CTRL-]|) to expand them on
+the go.
+
 ==============================================================================
  2. CUSTOMIZATION                                         *delimitMateOptions*