diff --git a/doc/nvim-tree-lua.txt b/doc/nvim-tree-lua.txt
index 436baf35..15147797 100644
--- a/doc/nvim-tree-lua.txt
+++ b/doc/nvim-tree-lua.txt
@@ -592,7 +592,9 @@ Git integration with icons and colors.
       Type: `boolean`, Default: `true`
 
     *nvim-tree.git.show_on_open_dirs*
-    Show status icons on directories that are open.
+    Show status icons of children on directories that are open.
+    Note that setting this to `false` will still show ignored icon on ignored
+    directories and deleted icons on directories whose children are deleted.
     Only relevant when `git.show_on_dirs` is `true`.
       Type: `boolean`, Default: `true`