diff --git a/doc/articles/scripts.md b/doc/articles/scripts.md
index 9f4504ae3..bbaea9c89 100644
--- a/doc/articles/scripts.md
+++ b/doc/articles/scripts.md
@@ -375,6 +375,7 @@ You can set custom script descriptions with the following in your `composer.json
 }
 ```
 
-The descriptions are seen in `composer run -l` command output.
+The descriptions are used in `composer list` or `composer run -l` commands to
+describe what the scripts do when the command is run.
 
 > **Note:** You can only set custom descriptions of custom commands.