diff --git a/build.gradle b/build.gradle
index 8bf638459..ea2ec5408 100644
--- a/build.gradle
+++ b/build.gradle
@@ -382,6 +382,9 @@ subprojects {
 
   apply from: "${rootDir.path}/java_common.gradle"
 
+  // When changing Java version here, be sure to update BEAM Java runtime:
+  // in core/build.gradle, search for `flex-template-base-image` and update
+  // the parameter value.
   sourceCompatibility = JavaVersion.VERSION_17
   targetCompatibility = JavaVersion.VERSION_17