diff --git a/bootstrap.sh b/bootstrap.sh
index c700dc0..52ef564 100644
--- a/bootstrap.sh
+++ b/bootstrap.sh
@@ -1,10 +1,20 @@
 #!/bin/sh
 
 ####
-#### WARNING: This shell script should do exactly the same things as the bootstrap playbook.
-####          The only exception is the script should run ansible-pull.sh when it's done.
+#### WARNING:
 ####
-####           ! Make sure to keep them in sync. !
+####     bootstrap.sh and bootstrap.yml should be updated together.  They should do the
+####     exact same things with the following exceptions:
+####
+####         * bootstrap.sh
+####           - at the end it should run ansible-pull.sh against bootstrap.yml
+####
+####         * bootstrap.yml
+####           - at the end it should configure cron to schedule ansible-pull.sh
+####
+####     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+####     ! Make sure to keep them in sync !
+####     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 ####
 
 
diff --git a/bootstrap.yml b/bootstrap.yml
index d326bff..067f828 100644
--- a/bootstrap.yml
+++ b/bootstrap.yml
@@ -1,10 +1,20 @@
 ---
 
 ####
-#### WARNING: This playbook should do exactly the same things as the bootstrap shell script.  
-####          The only exception is the script should run ansible-pull.sh when it's done. 
-#### 
-####           ! Make sure to keep them in sync. !
+#### WARNING: 
+####
+####     bootstrap.sh and bootstrap.yml should be updated together.  They should do the
+####     exact same things with the following exceptions:
+####
+####         * bootstrap.sh
+####           - at the end it should run ansible-pull.sh against bootstrap.yml
+####
+####         * bootstrap.yml
+####           - at the end it should configure cron to schedule ansible-pull.sh
+####
+####     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+####     ! Make sure to keep them in sync !
+####     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 ####