diff --git a/README.mkd b/README.mkd
index efbd559..5fea55c 100644
--- a/README.mkd
+++ b/README.mkd
@@ -23,9 +23,8 @@ Features:
 
 Constraints:
 
-* Supports git only.
-
-If you work with other version control systems, I recommend [vim-signify](https://github.com/mhinz/vim-signify).
+* Supports git only.  If you work with other version control systems, I recommend [vim-signify](https://github.com/mhinz/vim-signify).
+* Relies on the `FocusGained` event.  If your terminal doesn't report focus events, I suggest using something like [Terminus][].
 
 
 ### Screenshot
@@ -505,6 +504,10 @@ Here are some things you can check:
 
 * Try reducing `updatetime`, e.g. `set updatetime=100`.
 
+#### When signs don't update after focusing Vim
+
+* Your terminal probably isn't reporting focus events.  Try installing [Terminus][].
+
 
 ### Shameless Plug
 
@@ -525,3 +528,4 @@ Copyright Andrew Stewart, AirBlade Software Ltd.  Released under the MIT licence
   [pathogen]: https://github.com/tpope/vim-pathogen
   [siv]: http://pluralsight.com/training/Courses/TableOfContents/smash-into-vim
   [airblade]: http://airbladesoftware.com/peepcode-vim
+  [terminus]: https://github.com/wincent/terminus
diff --git a/doc/gitgutter.txt b/doc/gitgutter.txt
index 379383d..d7aefb6 100644
--- a/doc/gitgutter.txt
+++ b/doc/gitgutter.txt
@@ -488,3 +488,9 @@ Try reducing 'updatetime':
     set updatetime=100
 <
 
+
+When signs don't update after focusing Vim:~
+
+Your terminal probably isn't reporting focus events.  Try installing Terminus
+(https://github.com/wincent/terminus).
+