comments from PR

Author: thibault-barrat

docs/ReferenceArrayInput.md

@@ -46,7 +46,7 @@ import { ReferenceArrayInput, SelectArrayInput } from 'react-admin';
 | Prop               | Required | Type                                        | Default                            | Description                                                                                                         |
 |--------------------|----------|---------------------------------------------|------------------------------------|---------------------------------------------------------------------------------------------------------------------|
 | `filter`           | Optional | `Object`                                    | `{}`                               | Permanent filters to use for getting the suggestion list                                                            |
-| `label`            | Optional | `string`                                    | -                                  | A custom label can be used when `ReferenceArrayInput` is in a Filter array.                         |
+| `label`            | Optional | `string`                                    | -                                  | Useful only when `ReferenceArrayInput` is in a Filter array, the label is used as the Filter label.                         |
 | `page`             | Optional | `number`                                    | 1                                  | The current page number                                                                                             |
 | `perPage`          | Optional | `number`                                    | 25                                 | Number of suggestions to show                                                                                       |
 | `reference`        | Required | `string`                                    | ''                                 | Name of the reference resource, e.g. 'posts'.                                                                       |

docs/ReferenceInput.md

@@ -26,7 +26,7 @@ import { ReferenceInput, SelectInput } from 'react-admin';
 | Prop               | Required | Type                                        | Default                          | Description                                                                                                       |
 |--------------------|----------|---------------------------------------------|----------------------------------|-------------------------------------------------------------------------------------------------------------------|
 | `filter`           | Optional | `Object`                                    | `{}`                             | Permanent filters to use for getting the suggestion list                                                          |
-| `label`            | Optional | `string`                                    | -                                | A custom label can be used when `ReferenceInput` is in a Filter array.                         |
+| `label`            | Optional | `string`                                    | -                                | Useful only when `ReferenceInput` is in a Filter array, the label is used as the Filter label.                         |
 | `page`             | Optional | `number`                                    | 1                                | The current page number                                                                                           |
 | `perPage`          | Optional | `number`                                    | 25                               | Number of suggestions to show                                                                                     |
 | `reference`        | Required | `string`                                    | ''                               | Name of the reference resource, e.g. 'posts'.                                                                     |

docs/Upgrade.md

@@ -2709,7 +2709,7 @@ const UserInput = [
 ]
 ```
 
-**Note**: `<ReferenceInput>` and `<ReferenceArrayInput>` still accepts `label` prop only when they are used in a Filter array.
+**Note**: `<ReferenceInput>` and `<ReferenceArrayInput>` still accept the `label` prop, which is used as the Filter label when they are used in a Filter array.
 
 #### `<ReferenceArrayInput>` No Longer Provides a `ListContext`