docs: document JSON Schema deprecated support and UI options (#5061)

* docs: document JSON Schema deprecated support and UI options

* docs: move deprecated keyword to json-schema docs and refine uiSchema formatting

* docs: add note about JSON Schema Draft 2019-09 for deprecated keyword

Author: Suyog241005

packages/docs/docs/api-reference/uiSchema.md

@@ -333,6 +333,59 @@ const uiSchema: UiSchema = {
 };
 ```
 
+### deprecatedHandling
+
+The `ui:deprecatedHandling` uiSchema directive controls how a field marked as `deprecated` in the JSON Schema is rendered.
+
+Accepts one of three values:
+
+- `'label'` (default): The field is rendered normally with `"(deprecated)"` appended to its label.
+- `'disable'`: The field is rendered but all its child widgets are disabled.
+- `'hide'`: The field is completely hidden from the form.
+
+```tsx
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+
+const schema: RJSFSchema = {
+  type: 'object',
+  properties: {
+    legacyField: { type: 'string', deprecated: true },
+  },
+};
+
+const uiSchema: UiSchema = {
+  legacyField: {
+    'ui:options': {
+      deprecatedHandling: 'disable',
+    },
+  },
+};
+```
+
+It can also be set globally by specifying the `deprecatedHandling` option in the `ui:globalOptions` uiSchema directive, which applies the chosen behavior to every deprecated field in the form.
+
+```tsx
+import { Form } from '@rjsf/core';
+import { RJSFSchema, UiSchema } from '@rjsf/utils';
+import validator from '@rjsf/validator-ajv8';
+
+const schema: RJSFSchema = {
+  type: 'object',
+  properties: {
+    legacyField: { type: 'string', deprecated: true },
+    anotherOldField: { type: 'number', deprecated: true },
+  },
+};
+
+const uiSchema: UiSchema = {
+  'ui:globalOptions': {
+    deprecatedHandling: 'hide',
+  },
+};
+
+render(<Form schema={schema} uiSchema={uiSchema} validator={validator} />, document.getElementById('app'));
+```
+
 ### disabled
 
 The `ui:disabled` uiSchema directive will disable all child widgets from a given field.

packages/docs/docs/json-schema/single.md

@@ -44,6 +44,26 @@ const schema: RJSFSchema = {
 render(<Form schema={schema} validator={validator} />, document.getElementById('app'));
 ```
 
+## Deprecated fields
+
+The JSON Schema `deprecated` keyword can be used to indicate that a field is no longer supported.
+
+The `deprecated` keyword is a JSON Schema Draft 2019-09 feature. You may need to configure your schema validator to properly recognize it. See the [Validation](../usage/validation.md#ajvclass) documentation for more details.
+
+```tsx
+import { RJSFSchema } from '@rjsf/utils';
+import validator from '@rjsf/validator-ajv8';
+
+const schema: RJSFSchema = {
+  type: 'string',
+  deprecated: true,
+};
+
+render(<Form schema={schema} validator={validator} />, document.getElementById('app'));
+```
+
+By default, RJSF will append ` (deprecated)` to the field label. You can customize this behavior using the `deprecatedHandling` option in the uiSchema. See [deprecatedHandling](../api-reference/uiSchema.md#deprecatedhandling) for more details.
+
 ## Enumerated values
 
 All base schema types support the `enum` attribute, which restricts the user to select among a list of options. For example: