doc: update docs for useUnselect, useUnselectAll

Author: mikhail-fedosenko

docs/useUnselect.md

@@ -5,7 +5,11 @@ title: "useUnselect"
 
 # `useUnselect`
 
-This hook returns a function that unselects lines in the current `<DataTable>` that match an array of ids. Pass the name of the resource to the hook as argument.
+This hook returns a function that unselects lines in a `<DataTable>` that match an array of ids. Pass the name of the resource to the hook as the 1st argument.
+
+The 2nd optional argument accepts `storeKey`. It should match with the `storeKey` used in `useListController`.
+
+Returned function accepts boolean as the 2nd `fromAllStoreKeys` argument - if `true`, then it will unselect the records across all storeKeys used with this resource.
 
 ```jsx
 import { useListContext, useUnselect } from 'react-admin';

docs/useUnselectAll.md

@@ -5,7 +5,11 @@ title: "useUnselectAll"
 
 # `useUnselectAll`
 
-This hook returns a function that unselects all lines in the current `<DataTable>`. Pass the name of the resource as argument.
+This hook returns a function that unselects all lines in a `<DataTable>`. Pass the name of the resource as the 1st argument.
+
+The 2nd optional argument accepts `storeKey`. It should match with the `storeKey` used in `useListController`.
+
+Returned function accepts a boolean `fromAllStoreKeys` argument - if `true`, then it will unselect all records across all storeKeys used with this resource.
 
 ```jsx
 import { useUnselectAll } from 'react-admin';

docs_headless/src/content/docs/useUnselect.md

@@ -2,7 +2,11 @@
 title: "useUnselect"
 ---
 
-This hook returns a function that unselects lines in the current data table (see `<DataTableBase>`) that match an array of ids. Pass the name of the resource to the hook as argument.
+This hook returns a function that unselects lines in a data table (see `<DataTableBase>`) that match an array of ids. Pass the name of the resource to the hook as the 1st argument.
+
+The 2nd optional argument accepts `storeKey`. It should match with the `storeKey` used in `useListController`.
+
+Returned function accepts boolean as the 2nd `fromAllStoreKeys` argument - if `true`, then it will unselect the records across all storeKeys used with this resource.
 
 ```jsx
 import { useListContext, useUnselect } from 'ra-core';

docs_headless/src/content/docs/useUnselectAll.md

@@ -2,7 +2,11 @@
 title: "useUnselectAll"
 ---
 
-This hook returns a function that unselects all lines in the current data table (see `<DataTableBase>`). Pass the name of the resource as argument.
+This hook returns a function that unselects all lines in a data table (see `<DataTableBase>`). Pass the name of the resource as the 1st argument.
+
+The 2nd optional argument accepts `storeKey`. It should match with the `storeKey` used in `useListController`.
+
+Returned function accepts a boolean `fromAllStoreKeys` argument - if `true`, then it will unselect all records across all storeKeys used with this resource.
 
 ```jsx
 import { useUnselectAll } from 'ra-core';