diff --git a/playbooks/roles/edxapp/tasks/deploy.yml b/playbooks/roles/edxapp/tasks/deploy.yml
index 0b64745..6371ecb 100644
--- a/playbooks/roles/edxapp/tasks/deploy.yml
+++ b/playbooks/roles/edxapp/tasks/deploy.yml
@@ -83,6 +83,12 @@
     - install
     - install:code
 
+# edX supports two theme types, Comprehensive themes and the older
+# Stanford-style themes. They are mutually exclusive.
+#
+# To enable Stanford theming, point edxapp_theme_source_repo
+# (yes, lowercase) to a Stanford-style theme and set
+# edxapp_theme_name (again, lowercase) to its name.
 - name: checkout Stanford-style theme
   git: >
     dest={{ edxapp_app_dir }}/themes/{{ edxapp_theme_name }}
@@ -98,6 +104,10 @@
     - install
     - install:code
 
+# To enable Comprehensive theming, point
+# EDXAPP_COMPREHENSIVE_THEME_SOURCE_REPO to your theme repo, and set
+# EDXAPP_COMPREHENSIVE_THEME_DIR to the directory you want to check
+# out to.
 - name: checkout comprehensive theme
   git: >
     dest={{ EDXAPP_COMPREHENSIVE_THEME_DIR }}