diff --git a/src/corelib/doc/src/cmake/cmake-properties.qdoc b/src/corelib/doc/src/cmake/cmake-properties.qdoc
index f844fc3e701..ed4ed218481 100644
--- a/src/corelib/doc/src/cmake/cmake-properties.qdoc
+++ b/src/corelib/doc/src/cmake/cmake-properties.qdoc
@@ -508,6 +508,11 @@ this behavior on a per-target basis by setting the property to \c TRUE:
 set_property(TARGET target_name PROPERTY QT_NO_UTF8_SOURCE TRUE)
 \endcode
 
+\note This does not change the runtime behavior of classes like
+\l QString (its constructor from \c{const char *} requires properly encoded
+UTF-8 input). Use the \l QT_NO_CAST_FROM_ASCII and
+\c QT_RESTRICTED_CAST_FROM_ASCII macros to help identify such code.
+
 \sa {qt6_disable_unicode_defines}{qt_disable_unicode_defines()}{qt6_allow_non_utf8_sources()}
 */
 
diff --git a/src/corelib/doc/src/cmake/qt_allow_non_utf8_sources.qdoc b/src/corelib/doc/src/cmake/qt_allow_non_utf8_sources.qdoc
index 6e972ba63a1..b8091d38033 100644
--- a/src/corelib/doc/src/cmake/qt_allow_non_utf8_sources.qdoc
+++ b/src/corelib/doc/src/cmake/qt_allow_non_utf8_sources.qdoc
@@ -30,6 +30,11 @@ is currently implemented for Visual Studio and Intel compilers. You can disable
 this behavior on a per-target basis by calling \c{qt_allow_non_utf8_sources()}
 and passing the target as the argument.
 
+\note This does not change the runtime behavior of classes like
+\l QString (its constructor from \c{const char *} requires properly encoded
+UTF-8 input). Use the \l QT_NO_CAST_FROM_ASCII and
+\c QT_RESTRICTED_CAST_FROM_ASCII macros to help identify such code.
+
 \sa {qt6_disable_unicode_defines}{qt_disable_unicode_defines()}
     {cmake-target-property-QT_NO_UTF8_SOURCE}
 */