diff --git a/doc/api/crypto.md b/doc/api/crypto.md
index 351f32c11f6220..498efbf1812e2b 100644
--- a/doc/api/crypto.md
+++ b/doc/api/crypto.md
@@ -2309,7 +2309,8 @@ added: v10.0.0
 -->
 
 * Returns: {number} `1` if and only if a FIPS compliant crypto provider is
-  currently in use, `0` otherwise.
+  currently in use, `0` otherwise. A future semver-major release may change
+  the return type of this API to a {boolean}.
 
 ### `crypto.getHashes()`
 <!-- YAML