diff --git a/README.md b/README.md
index 03e6b2e..324bb44 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,8 @@ EOF
 
 ```bash
 $ (
+    # `sleep` gives bash time to be ready for the command, if this is omitted
+    # the appearance of prompts can get messed up.
     sleep 0.05
     echo -ne "for x in {16..231}; do printf \"\\\e[48;5;\${x}m%03d\\\e[0m \" \$x; done\r"
     sleep 0.05
diff --git a/scripts/examples.sh b/scripts/examples.sh
index f3b41d8..96be45b 100755
--- a/scripts/examples.sh
+++ b/scripts/examples.sh
@@ -12,6 +12,8 @@ termsnap -o ./media/cow.svg -l 9 -c 28 -- cowsay Hello, world
 
 
 (
+    # `sleep` gives bash time to be ready for the command, if this is omitted
+    # the appearance of prompts can get messed up.
     sleep 0.05
     echo -ne "for x in {16..231}; do printf \"\\\e[48;5;\${x}m%03d\\\e[0m \" \$x; done\r"
     sleep 0.05