HSEARCH-3849 Document the create-or-validate operation in the schema …

…manager API of the ORM mapper

documentation/src/main/asciidoc/mapper-orm-schema.asciidoc

@@ -118,6 +118,13 @@ because <<mapper-orm-schema-management-concepts-lucene-schema,local Lucene index
 |Creates missing indexes and their schema,
 but does not touch existing indexes and assumes their schema is correct without validating it.
 |<<mapper-orm-schema-management-concepts-massindexing,Creating a schema does not populate indexed data>>.
+|[[mapper-orm-schema-management-manager-create-or-validate]]`createOrValidate()`
+|Creates missing indexes and their schema,
+and validates the schema of existing indexes.
+|<<mapper-orm-schema-management-concepts-massindexing,Creating a schema does not populate indexed data>>.
+
+With the Lucene backend, validation is limited to checking that the indexes exist,
+because <<mapper-orm-schema-management-concepts-lucene-schema,local Lucene indexes don't have a schema>>.
 |[[mapper-orm-schema-management-manager-create-or-update]]`createOrUpdate()`
 |Creates missing indexes and their schema,
 and updates the schema of existing indexes if possible.

mapper/orm/src/main/java/org/hibernate/search/mapper/orm/schema/management/SearchSchemaManager.java

@@ -53,7 +53,8 @@ public interface SearchSchemaManager {
 	 * but their schema does not match the requirements of the Hibernate Search mapping:
 	 * missing fields, fields with incorrect type, missing analyzer definitions or normalizer definitions, ...
 	 * <p>
-	 * With Lucene, the schema of indexes is not validated.
+	 * <strong>Warning:</strong> with the Lucene backend, validation is limited to checking that the indexes exist,
+	 * because local Lucene indexes don't have a schema.
 	 */
 	void createOrValidate();