- Responded to reviewer feedback and updated migration guide

Author: heath-freenome

docs/5.x upgrade guide.md

@@ -262,8 +262,33 @@ From v5, the child fields will correctly use the parent id when generating its o
 
 ##### Non-standard `enumNames` property
 
-`enumNames` is a non-standard JSON Schema field that was deprecated in version 5. `enumNames` could be included in the schema to apply labels that differed from an enumeration value. This behavior can still be accomplished with `oneOf` or `anyOf` containing `const` values, so this behavior may be removed from a future major version of RJSF. For more information, see [#532](https://github.com/rjsf-team/react-jsonschema-form/issues/532).
+`enumNames` is a non-standard JSON Schema field that was deprecated in version 5.
+`enumNames` could be included in the schema to apply labels that differed from an enumeration value.
+This behavior can still be accomplished with `oneOf` or `anyOf` containing `const` values, so this behavior may be removed from a future major version of RJSF.
+For more information, see [#532](https://github.com/rjsf-team/react-jsonschema-form/issues/532).
 
+##### uiSchema.classNames
+
+In versions previous to 5, `uiSchema.classNames` was the only property that did not require the `ui:` prefix.
+Additionally, it did not support being added into the `ui:options` object.
+This was fixed in version 5 to be consistent with all the other properties in the `uiSchema`.
+
+If you are using `classNames` as follows, simply add the `ui:` prefix to it to remove the deprecation warning that will be displayed for each `uiSchema.classNames` you have:
+
+```jsx
+// This uiSchema will log a deprecation warning to the console
+const uiSchema = {
+  title: {
+    "classNames": "myClass" 
+  }
+};
+// This uiSchema will not
+const uiSchema = {
+  title: {
+    "ui:classNames": "myClass"
+  }
+};
+```
 
 ### `@rjsf/material-ui` BREAKING CHANGES
 

packages/core/src/components/fields/SchemaField.tsx

@@ -258,7 +258,7 @@ function SchemaFieldRender<T, F>(props: FieldProps<T, F>) {
   if (uiSchema?.classNames) {
     if (process.env.NODE_ENV !== "production") {
       console.warn(
-        "WARNING: 'uiSchema.classNames' is deprecated and may be removed in a major release; Use 'ui:classNames' instead."
+        "'uiSchema.classNames' is deprecated and may be removed in a major release; Use 'ui:classNames' instead."
       );
     }
     classNames.push(uiSchema.classNames);

packages/core/test/uiSchema_test.js

@@ -62,9 +62,7 @@ describe("uiSchema", () => {
       expect(bar.classList.contains("another-for-bar")).eql(true);
       expect(baz.classList.contains("class-for-baz")).eql(true);
       expect(
-        console.warn.calledWithMatch(
-          /WARNING: 'uiSchema.classNames' is deprecated/
-        )
+        console.warn.calledWithMatch(/'uiSchema.classNames' is deprecated/)
       ).to.be.true;
     });
   });