diff --git a/radicle-surf/src/repo.rs b/radicle-surf/src/repo.rs
index 766d3f4..9d75350 100644
--- a/radicle-surf/src/repo.rs
+++ b/radicle-surf/src/repo.rs
@@ -496,6 +496,16 @@ impl Repository {
         }
     }
 
+    /// Create a diff with the difference between two tree objects.
+    ///
+    /// Defines some options and flags that are passed to git2.
+    ///
+    /// Note:
+    /// libgit2 optimizes around not loading the content when there's no content
+    /// callbacks configured. Be aware that binaries aren't detected as
+    /// expected.
+    ///
+    /// Reference: <https://github.com/libgit2/libgit2/issues/6637>
     fn diff_commits(
         &self,
         path: Option<&Path>,