diff --git a/doc/design/assistant/inotify.mdwn b/doc/design/assistant/inotify.mdwn
index e6335e0451..fe4c26d412 100644
--- a/doc/design/assistant/inotify.mdwn
+++ b/doc/design/assistant/inotify.mdwn
@@ -30,6 +30,8 @@ really useful, it needs to:
   to check for ignored files)
 - Possibly, when a directory is moved out of the annex location,
   unannex its contents.
+- Gracefully handle when the default limit of 8192 inotified directories
+  is exceeded. This can be tuned by root, so help the user fix it.
 
 Also to do: