diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md
index 70a5bc521c..315ae01973 100644
--- a/docs/tools/kit/index.md
+++ b/docs/tools/kit/index.md
@@ -377,11 +377,12 @@ function RandomValues() {
 
 #### Notes:
 
-* Randomness is generated using Flow’s **on-chain `revertibleRandom`**, producing pseudorandom values tied to block and transaction execution.
-* The value returned for identical calls within the same block will be identical.
-* This hook is designed for simple use cases that **don’t require a [commit-reveal scheme]**, such as randomized UIs.
-* For **more advanced use cases** that **do** require a [commit-reveal scheme], Flow provides built-in support for that pattern.
-* Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated.
+* Randomness is generated using the **on-chain `revertibleRandom`** function on Flow, producing pseudorandom values tied to block and script execution.
+* Values are **deterministic**: The values returned for identical calls within the same block will be identical.
+* If `count ` is larger than one, the returned values are distinct.
+* This hook is designed for simple use cases that don't require unpredictability, such as randomized UIs.
+  Since the hook uses script executions on existing blocks, the random source is already public and the randoms are predictable. 
+* For **more advanced use cases** that **do** require on-chain randomness logic via transactions, Flow provides built-in support using Cadence's `revertibleRandom` and [commit-reveal scheme].
 
 ---