diff --git a/src/site/apt/toolchains/jdk.apt.vm b/src/site/apt/toolchains/jdk.apt.vm
index 04f2ac1..9a86c66 100644
--- a/src/site/apt/toolchains/jdk.apt.vm
+++ b/src/site/apt/toolchains/jdk.apt.vm
@@ -117,10 +117,9 @@ JDK Toolchain
         </configuration>
 +---+
 
-  Aside from version, the definitions are opaque strings. Maven looks in <<<toolchains.xml>>>
-  for a toolchain that provides version=="1.8" and vendor=="temurin". It does not know or care
-  what these strings mean. It does not, for instance, concern itself with whether the jdkHome configured
-  by the toolchain that satisfies version=="1.8" and vendor=="temurin" is JDK 8 from the Temurin project,
-  or JDK 21 from Oracle. JDK toolchain only checks that directory exists.
+  Aside from version, the values of <<<\<provides\>>>> elements are treated as opaque strings.
+  Maven looks in <<<toolchains.xml>>> for a toolchain that provides version=="1.8" and vendor=="temurin".
+  It does not interpret these strings semantically. For example, it does not validate that the jdkHome
+  directory actually contains a JDK matching the declared version and vendor.
 
   All conditions need to be satisfied to find a toolchain.