diff --git a/types/babel__core/index.d.ts b/types/babel__core/index.d.ts
index 7f03a7585a..3875d40d71 100644
--- a/types/babel__core/index.d.ts
+++ b/types/babel__core/index.d.ts
@@ -671,8 +671,9 @@ export interface EnvFunction {
      * @returns `true` if the `envName` is `===` any of the given strings
      */
     (envName: string | ReadonlyArray<string>): boolean;
-    // the official documentation is completely wrong for this one...
+    // the official documentation is misleading for this one...
     // this just passes the callback to `cache.using` but with an additional argument.
+    // it returns its result instead of necessarily returning a boolean.
     <T extends SimpleCacheKey>(envCallback: (envName: NonNullable<TransformOptions['envName']>) => T): T;
 }