diff --git a/docs/usage/deleting-rows-from-delta-lake-table.md b/docs/usage/deleting-rows-from-delta-lake-table.md
index e1833c84b9..6c852100e6 100644
--- a/docs/usage/deleting-rows-from-delta-lake-table.md
+++ b/docs/usage/deleting-rows-from-delta-lake-table.md
@@ -32,3 +32,7 @@ Here are the contents of the Delta table after the delete operation has been per
 |     2 | b        |
 +-------+----------+
 ```
+
+`dt.delete()` accepts any `SQL where` clause. If no predicate is provided, all rows will be deleted.
+
+Read more in the [API docs](https://delta-io.github.io/delta-rs/api/delta_table/#deltalake.DeltaTable.delete)