diff --git a/docs/api/hnsw_index.md b/docs/api/hnsw_index.md
index 56c1c3cd..deeb413a 100644
--- a/docs/api/hnsw_index.md
+++ b/docs/api/hnsw_index.md
@@ -512,4 +512,31 @@ pip install rust-annie[gpu]
 
 # Or build from source with GPU features
 maturin develop --release --features gpu
-```
\ No newline at end of file
+```
+
+## Code Changes
+
+The library has been updated to use the `rand` crate version `0.10.0`. This update ensures compatibility with the latest features and improvements in the `rand` ecosystem. Users should verify that their code is compatible with this version.
+
+```diff
+diff --git a/Cargo.toml b/Cargo.toml
+--- a/Cargo.toml
++++ b/Cargo.toml
+@@ -19,7 +19,7 @@ bincode = "1.3.3"
+ rayon = "1.11.0"
+ lazy_static = { version = "1.4.0", optional = true }
+ bit-vec = { version = "0.8.0", features = ["serde"] }
+-rand = "0.9.0"
++rand = "0.10.0"
+ criterion = { version = "0.8.1", optional = true }
+ 
+ # GPU backends
+@@ -45,7 +45,7 @@ members = [".", "fuzz", "rust_annie_macros/foo"]
+ 
+ [dev-dependencies]
+ criterion = "0.8"
+-rand = "0.9"
++rand = "0.10"
+```
+
+This change may affect random number generation and related functionalities. Users should review their code to ensure compatibility with the new version of the `rand` crate.
\ No newline at end of file
diff --git a/docs/api/threadsafe_index.md b/docs/api/threadsafe_index.md
index 3b8ded3d..94ffeadb 100644
--- a/docs/api/threadsafe_index.md
+++ b/docs/api/threadsafe_index.md
@@ -188,4 +188,8 @@ The introduction of the `python3-dll-a` dependency may affect thread safety or i
 
 ### Criterion Update
 
-The `criterion` dependency has been updated to version 0.8.0. Ensure that any performance testing or examples using `criterion` are compatible with this new version. This update may include changes in benchmarking features or API usage, so review the `criterion` documentation for any necessary adjustments.
\ No newline at end of file
+The `criterion` dependency has been updated to version 0.8.0. Ensure that any performance testing or examples using `criterion` are compatible with this new version. This update may include changes in benchmarking features or API usage, so review the `criterion` documentation for any necessary adjustments.
+
+### Rand Crate Update
+
+The `rand` crate has been updated to version 0.10.0. Ensure that any random number generation in examples or tests is compatible with this new version. This update may include changes in API usage, so review the `rand` documentation for any necessary adjustments.
\ No newline at end of file