diff --git a/lib/src/repo.rs b/lib/src/repo.rs
index 10da444d6de..6be4b4fc9c9 100644
--- a/lib/src/repo.rs
+++ b/lib/src/repo.rs
@@ -1314,6 +1314,11 @@ impl MutableRepo {
         result
     }
 
+    /// Reparent descendants of the rewritten commits.
+    ///
+    /// The descendants of the commits registered in `self.parent_mappings` will
+    /// be recursively rebased onto the new version of their parents.
+    /// Returns the number of rebased descendants.
     pub fn rebase_descendants(&mut self, settings: &UserSettings) -> BackendResult<usize> {
         let roots = self.parent_mapping.keys().cloned().collect_vec();
         let mut num_rebased = 0;