[pickers] Improve onError JSDoc (mui#14492)

docs/translations/api-docs/date-pickers/date-field/date-field.json

@@ -66,10 +66,10 @@
     },
     "onClear": { "description": "Callback fired when the clear button is clicked." },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/date-picker/date-picker.json

@@ -77,10 +77,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/date-range-picker/date-range-picker.json

@@ -91,10 +91,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/date-time-field/date-time-field.json

@@ -83,10 +83,10 @@
     },
     "onClear": { "description": "Callback fired when the clear button is clicked." },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/date-time-picker/date-time-picker.json

@@ -97,10 +97,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/date-time-range-picker/date-time-range-picker.json

@@ -108,10 +108,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/desktop-date-picker/desktop-date-picker.json

@@ -74,10 +74,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/desktop-date-range-picker/desktop-date-range-picker.json

@@ -88,10 +88,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/desktop-date-time-picker/desktop-date-time-picker.json

@@ -94,10 +94,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/desktop-date-time-range-picker/desktop-date-time-range-picker.json

@@ -105,10 +105,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/desktop-time-picker/desktop-time-picker.json

@@ -66,10 +66,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onOpen": {

docs/translations/api-docs/date-pickers/mobile-date-picker/mobile-date-picker.json

@@ -74,10 +74,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/mobile-date-range-picker/mobile-date-range-picker.json

@@ -83,10 +83,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/mobile-date-time-picker/mobile-date-time-picker.json

@@ -94,10 +94,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/mobile-date-time-range-picker/mobile-date-time-range-picker.json

@@ -100,10 +100,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {

docs/translations/api-docs/date-pickers/mobile-time-picker/mobile-time-picker.json

@@ -66,10 +66,10 @@
       "description": "Callback fired when the popup requests to be closed. Use in controlled mode (see <code>open</code>)."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onOpen": {

docs/translations/api-docs/date-pickers/multi-input-date-range-field/multi-input-date-range-field.json

@@ -34,10 +34,10 @@
       }
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/multi-input-date-time-range-field/multi-input-date-time-range-field.json

@@ -51,10 +51,10 @@
       }
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/multi-input-time-range-field/multi-input-time-range-field.json

@@ -43,10 +43,10 @@
       }
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/single-input-date-range-field/single-input-date-range-field.json

@@ -67,10 +67,10 @@
     },
     "onClear": { "description": "Callback fired when the clear button is clicked." },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/single-input-date-time-range-field/single-input-date-time-range-field.json

@@ -84,10 +84,10 @@
     },
     "onClear": { "description": "Callback fired when the clear button is clicked." },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/single-input-time-range-field/single-input-time-range-field.json

@@ -76,10 +76,10 @@
     },
     "onClear": { "description": "Callback fired when the clear button is clicked." },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onSelectedSectionsChange": {

docs/translations/api-docs/date-pickers/static-date-picker/static-date-picker.json

@@ -60,10 +60,10 @@
       "description": "Callback fired when component requests to be closed. Can be fired when selecting (by default on <code>desktop</code> mode) or clearing a value."
     },
     "onError": {
-      "description": "Callback fired when the error associated to the current value changes. If the error has a non-null value, then the <code>TextField</code> will be rendered in <code>error</code> state.",
+      "description": "Callback fired when the error associated with the current value changes. When a validation error is detected, the <code>error</code> parameter contains a non-null value. This can be used to render an appropriate form error.",
       "typeDescriptions": {
-        "error": "The new error describing why the current value is not valid.",
-        "value": "The value associated to the error."
+        "error": "The reason why the current value is not valid.",
+        "value": "The value associated with the error."
       }
     },
     "onMonthChange": {