Fix comment

Author: Fokko

pyiceberg/table/__init__.py

@@ -582,6 +582,11 @@ def delete(self, delete_filter: Union[str, BooleanExpression], snapshot_properti
         """
         Shorthand for deleting record from a table.
 
+        An deletee may produce zero or more snapshots based on the operation:
+
+            - DELETE: In case existing Parquet files can be dropped completely.
+            - REPLACE: In case existing Parquet files need to be rewritten
+
         Args:
             delete_filter: A boolean expression to delete rows from a table
             snapshot_properties: Custom properties to be added to the snapshot summary