Update bulk-delete.md

Author: JonathanMagnan

docs2/pages/documentations/bulk-delete.md

@@ -1,38 +1,116 @@
 # Bulk Delete
 
-## Bulk Delete
-Execute a DELETE operation.
+## Description
 
-### Example - Bulk Insert
-```csharp
-var dt = new DataTable();
-// ...seed...
+The `BulkDelete` method let you delete a large number of entities in your database.
 
-var bulk = new BulkOperation(connection);
+```csharp
+// Easy to use
+bulk.DestinationTableName = "Customers";
+bulk.BulkDelete(customers);
 
 // Easy to customize
-bulk.BatchSize = 1000;
-
-// Easy to use
-bulk.BulkDelete(dt);
+bulk.DestinationTableName = "Customers";
+bulk.BatchSize = 100;
+bulk.BulkDelete(customers);
 ```
+[Try it (DataTable)](https://dotnetfiddle.net/XgKaqz)
+
+[Try it (Entity)](https://dotnetfiddle.net/O3jY32)
+
+
+### Performance View
+
+| Operations      | 1,000 Entities | 2,000 Entities | 5,000 Entities |
+| :-------------- | -------------: | -------------: | -------------: |
+| BulkDelete      | 50 ms          | 55 ms          | 75 ms         |
+
+
+[Try it (DataTable)](https://dotnetfiddle.net/TknFpT)
+
+[Try it (Entity)](https://dotnetfiddle.net/CzSZx8)
+
+> HINT: A lot of factors might affect the benchmark time such as index, column type, latency, throttling, etc.
+
+### Scenarios
+The `BulkDelete` method is **fast** but also **flexible** to let you handle various scenarios such as:
+
+- [Delete with custom key](#delete-with-custom-key)
+- [More scenarios](#more-scenarios)
+
+### Advantages
+- Easy to use
+- Flexible
+- Increase performance
+- Increase application responsiveness
+
+## Getting Started
+
+### Bulk Delete
+The `BulkDelete` and `BulkDeleteAync` methods your let you delete a large number of entities in your database.
 
-### Example - Bulk Insert Generic
 ```csharp
-var list = new List<Customer>();
-// ...seed...
+bulk.BulkDelete(customers);
 
-var bulk = new BulkOperation<Customer>(connection);
+bulk.BulkDeleteAsync(customers, cancellationToken);
+```
+[Try it (DataTable)](https://dotnetfiddle.net/Ss93gv)
 
-// Easy to customize
-bulk.BatchSize = 1000;
+[Try it (Entity)](https://dotnetfiddle.net/p8dt0G) 
 
-// Easy to use
+### Bulk Delete with options
+The `options` parameter let you use a lambda expression to customize the way entities are deleted.
+
+```csharp
+bulk.BatchSize = 100;
 bulk.BulkDelete(customers);
 ```
+[Try it (DataTable)](https://dotnetfiddle.net/NQlmua)
+
+[Try it (Entity)](https://dotnetfiddle.net/KLFfCw) 
+
+## Real Life Scenarios
+
+### Delete with custom key
+You want to delete entities, but you don't have the primary key. The `ColumnPrimaryKeyExpression` let you use as a key any property or combination of properties.
+
+```csharp
+bulk.AutoMapKeyName = "Code";
+bulk.BulkDelete(dtCustomers.AsEnumerable().Take(2));
+```
+[Try it (DataTable)](https://dotnetfiddle.net/XKUBto)
+
+```csharp
+bulk.AutoMapKeyExpression = customer => customer.Code;
+bulk.BulkDelete(customers.Take(2));
+```
+[Try it (Entity)](https://dotnetfiddle.net/yc5tqc) 
+
+### More scenarios
+Hundred of scenarios has been solved and are now supported.
+
+The best way to ask for a special request or to find out if a solution for your scenario already exists is by contacting us:
+info@zzzprojects.com
+
+## Documentation
+
+### BulkDelete
+
+###### Methods
+
+| Name | Description | Example (DataTable) | Example (Entity) |
+| :--- | :----------  | :------ | :------ |
+| `BulkDelete<T>(items)` | Bulk delete entities in your database. | [Try it (Entity)](https://dotnetfiddle.net/a6Txdy) | [Try it (DataTable)](https://dotnetfiddle.net/srOJJ8) 
+| `BulkDeleteAsync<T>(items)` | Bulk delete entities asynchronously in your database. | | |
+| `BulkDeleteAsync<T>(items, cancellationToken)` | Bulk delete entities asynchronously in your database. | | |
 
-### Performance Benchmarks
+###### Options
+More options can be found here:
 
-| Operations      | 1,000 Rows     | 10,000 Rows    | 100,000 Rows   | 1,000,000 Rows |
-| :-------------- | -------------: | -------------: | -------------: | -------------: |
-| BulkDelete      | 45 ms          | 70 ms          | 625 ms         | 6,800 ms       |
+- [Audit](https://bulk-operations.net/audit)
+- [Batch](https://bulk-operations.net/batch)
+- [Execute Event](https://bulk-operations.net/execute-event)
+- [Log](https://bulk-operations.net/log)
+- [Temporary Table](https://bulk-operations.net/temporary-table)
+- [Transient Error](https://bulk-operations.net/transient-error)
+- [SQL Server](https://bulk-operations.net/sql-server)