diff --git a/tests/scripts/quiet/quiet b/tests/scripts/quiet/quiet
index bbc685cd8b..8f83d07638 100755
--- a/tests/scripts/quiet/quiet
+++ b/tests/scripts/quiet/quiet
@@ -9,6 +9,17 @@
 # If you are debugging a build / CI issue, you can get complete unsilenced logs
 # by un-commenting the following line (or setting VERBOSE_LOGS in your environment):
 # VERBOSE_LOGS=1
+#
+# This script provides most of the functionality for the adjacent make and cmake
+# wrappers.
+#
+# It requires two variables to be set:
+#
+# TOOL       - the name of the tool that is being wrapped (with no path), e.g. "make"
+#
+# NO_SILENCE - a regex that describes the commandline arguments for which output will not
+#              be silenced, e.g. " --version | test ". In this example, "make test" will
+#              not be silent, but "make lib" will be.
 
 # Locate original tool
 TOOL_WITH_PATH=$(dirname "$0")/$TOOL