Address 4618 documentation issues (rjsf-team#4624)

Improves the documentation for precompiled validators based on rjsf-team#4618 feedback
- Updated `validation.md` to improve the documentation
- Updated `CHANGELOG.md` to reflect this change

Author: heath-freenome

CHANGELOG.md

@@ -27,6 +27,10 @@ should change the heading of the (upcoming) version to include a major version b
 - Added `getChakra` to package exports
 - Restored the `ui:options` customization
 
+## Dev / docs / playground
+
+- Updated precompiled schemas documentation in `validation.md` based on v6 changes, addressingg [#4618](https://github.com/rjsf-team/react-jsonschema-form/issues/4618)
+
 # 6.0.0-beta.7
 
 ## @rjsf/core

packages/docs/docs/usage/validation.md

@@ -32,13 +32,15 @@ The `@rjsf/validator-ajv8` package exports the `compileSchemaValidators()` funct
 It is expected that this function will be used in a manner similar to the following:
 
 ```cjs
-const compileSchemaValidators = require('@rjsf/validator-ajv8/dist/compileSchemaValidators').default;
+const compileSchemaValidators = require('@rjsf/validator-ajv8/compileSchemaValidators').default;
 const yourSchema = require('path_to/yourSchema'); // If your schema is a js file
 
 compileSchemaValidators(yourSchema, 'path_to/yourCompiledSchema.js');
 ```
 
-If you are currently using the `customizeValidator()` function to provide `additionalMetaSchemas`, `customFormats`, `ajvOptionsOverrides` and/or `ajvFormatOptions` then you can pass those in as the optional third parameter to the `compileSchemaValidators()` function in a manner similar to:
+If you are currently using the `customizeValidator()` function to provide `additionalMetaSchemas`, `customFormats`,
+`ajvOptionsOverrides` and/or `ajvFormatOptions` then you can pass those in as the optional third parameter to the
+`compileSchemaValidators()` function in a manner similar to:
 
 ```cjs
 const { compileSchemaValidators } = require('@rjsf/validator-ajv8');
@@ -76,23 +78,32 @@ The `@rjsf/validator-ajv8` package exports the `createPrecompiledValidator()` fu
 Here is an example of how to use your precompiled validator with your `Form`:
 
 ```tsx
+import { useMemo } from 'react';
 import { createPrecompiledValidator, ValidatorFunctions } from '@rjsf/validator-ajv8';
-import Form from '@rjsf/core'; // Or whatever theme you use
+import Form, { FormProps } from '@rjsf/core'; // Or whatever theme you use
 
 import yourSchema from 'path_to/yourSchema'; // This needs to be the same file that was precompiled
-import * as precompiledValidator from 'path_to/yourCompiledSchema';
+import * as precompiledValidatorFns from 'path_to/yourCompiledSchema';
 
-const validator = createPrecompiledValidator(precompiledValidator as ValidatorFunctions);
+function MyForm(props: Omit<FormProps, 'validator' | 'schema'>) {
+  // Memoize the validator to avoid rerenders
+  const validator = useMemo(
+    () => createPrecompiledValidator(precompiledValidatorFns, yourSchema),
+    [validatorFns, yourSchema],
+  );
+
+  return <Form schema={yourSchema} validator={validator} />;
+}
 
-render(<Form schema={yourSchema} validator={validator} />, document.getElementById('app'));
+render(<MyForm />, document.getElementById('app'));
 ```
 
 ### Dynamically pre-compiling validators
 
 For more advanced cases when schema needs to be precompiled on request - `compileSchemaValidatorsCode` can be used.
 
 ```ts
-import { compileSchemaValidatorsCode } from '@rjsf/validator-ajv8/dist/compileSchemaValidators';
+import { compileSchemaValidatorsCode } from '@rjsf/validator-ajv8/compileSchemaValidators';
 
 const code = compileSchemaValidatorsCode(schema, options);
 ```
@@ -140,15 +151,15 @@ const regexp = new RegExp(
   Object.keys(validatorsBundleReplacements)
     .map((key) => key.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&'))
     .join('|'),
-  'g'
+  'g',
 );
 
 function wrapAjvBundle(code: string) {
   return `function(${Object.values(validatorsBundleReplacements)
     .map(([name]) => name)
     .join(', ')}){\nvar exports = {};\n${code.replace(
     regexp,
-    (req) => validatorsBundleReplacements[req][0]
+    (req) => validatorsBundleReplacements[req][0],
   )};\nreturn exports;\n}`;
 }
 
@@ -206,7 +217,7 @@ React.useEffect(() => {
   evaluateValidator(
     schemaId, // some schema id to avoid evaluating it multiple times
     code, // result of compileSchemaValidatorsCode returned from the server
-    nonce // nonce script tag attribute to allow this ib content security policy for the page
+    nonce, // nonce script tag attribute to allow this ib content security policy for the page
   ).then(setPrecompiledValidator);
 }, [entityType.id]);
 
@@ -353,7 +364,7 @@ const schema: RJSFSchema = {
 
 render(
   <Form schema={schema} validator={validator} transformErrors={transformErrors} />,
-  document.getElementById('app')
+  document.getElementById('app'),
 );
 ```