diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
index 50d094e9..0c8cf3f2 100644
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@@ -1,6 +1,3 @@
-# the version catalog is currently limited to a single file due to dependabot
-# see https://github.com/dependabot/dependabot-core/issues/8079 for details
-
 [versions]
 shadow = "8.1.1"
 jib = "3.4.0"
diff --git a/settings.gradle.kts b/settings.gradle.kts
index 65e02881..ecdea237 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -24,6 +24,9 @@ include("testing:agent-for-testing")
 dependencyResolutionManagement {
     versionCatalogs {
         create("catalog") {
+          // the version catalog is currently limited to a single file due to dependabot
+          // see https://github.com/dependabot/dependabot-core/issues/8079 for details.
+          // Also, only the 'gradle/libs.versions.toml' path is supported for now.
           from(files("gradle/libs.versions.toml"))
         }
     }