diff --git a/doc/git-subrepo.swim b/doc/git-subrepo.swim
index 96dc0141..ccab6d1a 100644
--- a/doc/git-subrepo.swim
+++ b/doc/git-subrepo.swim
@@ -76,7 +76,9 @@ The best short answer is:
 
 The complete "Installation Instructions" can be found below.
 
-Note: git-subrepo needs a git version (> 2.7) that supports worktree:s.
+Notes:
+* git-subrepo needs a git version (> 2.7) that supports worktree:s.
+* some commands may break if the repository contains a branch named "subrepo".
 
 = Commands