[ABI Validation] Recommend setting up rootProject.name

* Recommend setting up rootProject.name * Fixed typos and rephrased the warning text Co-authored-by: Zongle Wang <[email protected]> Pull request Kotlin/binary-compatibility-validator#268
JetBrains · Dec 3, 2024 · a53f253 · a53f253
1 parent 7a8db5b
commit a53f253
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/libraries/tools/abi-validation/README.md b/libraries/tools/abi-validation/README.md
@@ -207,6 +207,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`.