diff --git a/README.md b/README.md
index 44713454..9adbb9dc 100644
--- a/README.md
+++ b/README.md
@@ -205,6 +205,12 @@ annotated with corresponding target names.
 During the validation phase, that file is compared to the dump extracted from the latest version of the library, 
 and any differences between these two files are reported as errors.
 
+Generated ABI dumps include a library name,
+so it's [recommended](https://docs.gradle.org/current/userguide/multi_project_builds.html#sec:naming_recommendations) 
+to set Gradle's `rootProject.name` for your library. 
+Without declaring the root project's name, Gradle defaults to using the project's directory name, which can lead to 
+unstable validation behavior due to potential mismatches in naming.
+
 Currently, all options described in [Optional parameters](#optional-parameters) section are supported for klibs too.
 The only caveat here is that all class names should be specified in the JVM-format,
 like `package.name.ClassName$SubclassName`.