Add links to soft delete feature

Author: fzaninotto

docs/Buttons.md

@@ -838,7 +838,7 @@ If your `authProvider` implements [Access Control](./Permissions.md#access-contr
 
 ## `<DeleteButton>`
 
-Delete the current record.
+Deletes the current record.
 
 ![Delete button](./img/DeleteButton.png)
 
@@ -867,6 +867,8 @@ You can also call it with a record and a resource:
 ```
 {% endraw %}
 
+**Tip**: React-admin provides a [`<SoftDeleteButton>`](./SoftDeleteButton.md) variant, which archives the record instead of deleting it. Check out the [Soft Delete documentation](./SoftDeleteDataProvider.md) for more information.
+
 ### Props
 
 | Prop                | Required | Type                             | Default           | Description                                                             |

docs/Features.md

@@ -1047,6 +1047,48 @@ const dataProvider = addEventsForMutations(
 );
 ```
 
+## Soft Delete
+
+React-admin lets you implement **soft delete** in your admin app, so that users can recover deleted records.
+
+![Soft delete example](https://react-admin-ee.marmelab.com/assets/DeletedRecordsList.png)
+
+Replace the standard `<DeleteButton>` with the [`<SoftDeleteButton>`](./SoftDeleteButton.md) in your `<List>`, `<Show>`, and `<Edit>` views to enable soft delete:
+
+```jsx
+import { List, DataTable, TextField } from 'react-admin';
+import { SoftDeleteButton } from '@react-admin/ra-soft-delete';
+
+export const PostList = () => (
+    <List>
+        <DataTable>
+            <DataTable.Col source="id" />
+            <DataTable.Col source="title" />
+            <DataTable.Col>
+                <SoftDeleteButton />
+            </DataTable.Col>
+        </DataTable>
+    </List>
+);
+```
+
+Then, add a `<DeletedRecordsList>` somewhere in your app to let users view and restore deleted records:
+
+```jsx
+import { Admin, CustomRoutes } from 'react-admin';
+import { DeletedRecordsList } from '@react-admin/ra-soft-delete';
+
+const App = () => (
+    <Admin>
+        <CustomRoutes>
+            <Route path="/deleted-records" element={<DeletedRecordsList />} />
+        </CustomRoutes>
+    </Admin>
+);
+```
+
+Check out the [Soft Delete Documentation](./SoftDeleteDataProvider.md) to learn more.
+
 ## Calendar
 
 If your app needs to display **events**, **appointments**, **time intervals**, or any other kind of time-based data, you can use the [`<Calendar>`](./Calendar.md) component.

docs/SoftDeleteDataProvider.md

@@ -5,7 +5,7 @@ title: "Soft Delete Setup"
 
 # Soft Delete Setup
 
-The soft delete feature is an Enterprise Edition add-on that allows you to "delete" records without actually removing them from your database. 
+The soft delete feature is an [Enterprise Edition add-on](https://react-admin-ee.marmelab.com/documentation/ra-soft-delete) that allows you to "delete" records without actually removing them from your database. 
 
 Use it to:
 

docs/Toolbar.md

@@ -96,3 +96,25 @@ You can override the style of the toolbar using the `sx` prop. Use the class nam
 | `& .RaToolbar-defaultToolbar`  | Applied to the internal wrapper of the `<Toolbar>` buttons when no children are passed |
 
 To override the style of all instances of `<Toolbar>` components using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaToolbar` key.
+
+## Soft Delete
+
+`<Toolbar>` displays a `<DeleteButton>` by default. React-admin provides a [`<SoftDeleteButton>`](./SoftDeleteButton.md) variant, which archives the record instead of deleting it. 
+
+To replace the default `<DeleteButton>` with a `<SoftDeleteButton>`, create a custom toolbar:
+
+{% raw %}
+```jsx
+import { Toolbar, SaveButton } from 'react-admin';
+import { SoftDeleteButton } from '@react-admin/ra-soft-delete';
+
+const MyToolbar = () => (
+    <Toolbar sx={{ justifyContent: 'space-between' }}>
+        <SaveButton label="Save" />
+        <SoftDeleteButton />
+    </Toolbar>
+);
+```
+{% endraw %}
+
+Then inject it to `<SimpleForm>` or `<TabbedForm>` using the `toolbar` prop.

docs/useDelete.md

@@ -81,3 +81,21 @@ useDelete<Product, Error>(undefined, undefined, {
     },
 })
 ```
+
+## Soft Delete
+
+Many applications require a "soft delete" feature, where records are not permanently removed from the database but are instead marked as deleted. This allows for easy recovery of deleted records and helps maintain data integrity.
+
+`useSoftDelete`, part of [the `ra-soft-delete` Enterprise Edition module](https://react-admin-ee.marmelab.com/documentation/ra-soft-delete), works similarly to `useDelete`, but it calls `dataProvider.softDelete()` instead of `dataProvider.delete()`. 
+
+```tsx
+const [softDeleteOne, { data, isPending, error }] = useSoftDelete(
+    resource,
+    { id, authorId, previousData, meta },
+    options,
+);
+```
+
+The `authorId` parameter is optional, and is populated automatically if you have an `authProvider` with a `getIdentity` method.
+
+Check the [Soft Delete documentation](./SoftDeleteDataProvider.md) for more information.

docs/useDeleteMany.md

@@ -80,3 +80,21 @@ useDeleteMany<Product, Error>(undefined, undefined, {
     },
 })
 ```
+
+## Soft Delete
+
+Many applications require a "soft delete" feature, where records are not permanently removed from the database but are instead marked as deleted. This allows for easy recovery of deleted records and helps maintain data integrity.
+
+`useSoftDeleteMany`, part of [the `ra-soft-delete` Enterprise Edition module](https://react-admin-ee.marmelab.com/documentation/ra-soft-delete), works similarly to `useDeleteMany`, but it calls `dataProvider.softDeleteMany()` instead of `dataProvider.deleteMany()`. 
+
+```tsx
+const [softDeleteMany, { data, isPending, error }] = useSoftDeleteMany(
+    resource,
+    { ids, authorId, meta },
+    options,
+);
+```
+
+The `authorId` parameter is optional, and is populated automatically if you have an `authProvider` with a `getIdentity` method.
+
+Check the [Soft Delete documentation](./SoftDeleteDataProvider.md) for more information.