diff --git a/docs/changelogs/v0.40.md b/docs/changelogs/v0.40.md
index 3c8950556..0e691d53b 100644
--- a/docs/changelogs/v0.40.md
+++ b/docs/changelogs/v0.40.md
@@ -58,7 +58,7 @@ The `test-cid-v1` and `test-cid-v1-wide` profiles have been removed. Use `unixfs
 
 **HAMT Threshold Fix**
 
-HAMT directory sharding threshold changed from `>=` to `>` to match the JS implementation ([ipfs/boxo@6707376](https://github.com/ipfs/boxo/commit/6707376002a3d4ba64895749ce9be2e00d265ed5)). A directory exactly at 256 KiB now stays as a basic directory instead of converting to HAMT.
+HAMT directory sharding threshold changed from `>=` to `>` to match the GO docs and JS implementation ([ipfs/boxo@6707376](https://github.com/ipfs/boxo/commit/6707376002a3d4ba64895749ce9be2e00d265ed5)). A directory exactly at 256 KiB now stays as a basic directory instead of converting to HAMT. This is a theoretical breaking change, but unlikely to impact real-world users as it requires a directory to be exactly at the threshold boundary. If you depend on the old behavior, adjust [`Import.UnixFSHAMTShardingSize`](https://github.com/ipfs/kubo/blob/master/docs/config.md#importunixfshamtshardingsize) to be 1 byte lower.
 
 #### 🧹 Automatic cleanup of interrupted imports