Add comment

crates/fj-kernel/src/algorithms/transform/mod.rs

@@ -97,6 +97,10 @@ where
             Self::Partial(partial) => partial.transform(transform, objects)?,
         };
 
+        // Transforming a `MaybePartial` *always* results in a partial object.
+        // This provides the most flexibility to the caller, who might want to
+        // use the transformed partial object for merging or whatever else,
+        // before building it themselves.
         Ok(Self::Partial(transformed))
     }
 }