diff --git a/roles/transmission/files/update-transmission-settings b/roles/transmission/files/update-transmission-settings
index d51730a..27cf1c0 100644
--- a/roles/transmission/files/update-transmission-settings
+++ b/roles/transmission/files/update-transmission-settings
@@ -2,7 +2,8 @@
 
 #
 # Update the transmission settings.json. For the update, stop transmission,
-# put the new file in place, and restart it.
+# put the new file in place, and restart it. This is necessary because
+# transmission is constantly rewriting the settings file while it is running.
 #
 
 set -e