diff --git a/docs/tools/kit/index.md b/docs/tools/kit/index.md
index 2170fccc4a..70a5bc521c 100644
--- a/docs/tools/kit/index.md
+++ b/docs/tools/kit/index.md
@@ -377,11 +377,11 @@ 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 intended for **non-critical randomness** like randomized UIs, loot crates, and temporary rewards.
-- For **critical applications** requiring secure and unpredictable randomness, use a [commit-reveal scheme] on Flow instead.
-- Values are **deterministic**: if a transaction fails and retries, the same random value will be regenerated.
+* 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.
 
 ---