diff --git a/gix/src/object/tree/diff/mod.rs b/gix/src/object/tree/diff/mod.rs
index 447eeaa84c4..5f7a041e4df 100644
--- a/gix/src/object/tree/diff/mod.rs
+++ b/gix/src/object/tree/diff/mod.rs
@@ -34,6 +34,10 @@ impl<'repo> Tree<'repo> {
     ///
     /// It's highly recommended to set an object cache to avoid extracting the same object multiple times.
     /// By default, similar to `git diff`, rename tracking will be enabled if it is not configured.
+    ///
+    /// Note that if a clone with `--filter=blob=none` was created, rename tracking may fail as it might
+    /// try to access blobs to compute a similarity metric. Thus, it's more compatible to turn rewrite tracking off
+    /// using [`Platform::track_rewrites()`].
     #[allow(clippy::result_large_err)]
     pub fn changes<'a>(&'a self) -> Result<Platform<'a, 'repo>, rewrites::Error> {
         Ok(Platform {