diff --git a/README.md b/README.md
index b58b534..6fa506a 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ mytoolkit templates register ~/workspace/templates   # one-time, points at templ
 
 ## Update
 
-`git pull` or `git submodule update` only updates the source tree. The installed Python package is **not** refreshed automatically. After pulling new code, rerun:
+The installed Python package is **not** refreshed automatically when the source tree changes. After editing source files, or after `git pull` / `git submodule update`, rerun:
 
 ```bash
 make install            # or: mytoolkit update