diff --git a/src/corelib/text/qstringview.h b/src/corelib/text/qstringview.h
index 7e70238cb2..b3206cc6e7 100644
--- a/src/corelib/text/qstringview.h
+++ b/src/corelib/text/qstringview.h
@@ -40,6 +40,18 @@
 #ifndef QSTRINGVIEW_H
 #define QSTRINGVIEW_H
 
+/*
+    This macro enables three "levels" of QStringView support:
+
+    1. offer QStringView, overload some functions taking QString with
+    QStringView
+
+    2. like 1, but remove all overloads of functions taking QStringRef,
+    leaving only the function taking QStringView.  Do this only where
+    QStringRef overloads tradionally existed.
+
+    3. like 2, but replace functions taking QString, too.
+*/
 #ifndef QT_STRINGVIEW_LEVEL
 #  define QT_STRINGVIEW_LEVEL 1
 #endif