diff --git a/script/docker-smoke b/script/docker-smoke
index 6116644..05ed46a 100755
--- a/script/docker-smoke
+++ b/script/docker-smoke
@@ -16,8 +16,10 @@ main() {
     # removed on exit.
     key="$(head -c 32 /dev/urandom | base64)"
 
-    # --health-interval=1s overrides the image's 30s interval so the
-    # first probe does not use up the whole wait.
+    # Docker 25 and later probe every 5 seconds during the image's
+    # 10-second start period. --health-interval=1s makes it probe every
+    # second after that instead of every 30, so a slow start still shows
+    # as healthy within the 30-second wait.
     cid="$(docker create --health-interval=1s \
         -e PIXA_SIGNING_KEY="$key" "$("$SCRIPT_DIR/projectname")")"
     # Remove the container on any exit; turning signals into exit makes