Please include the information about unrecognized inherited Hibernate Search fields in the Hibernate Search Guide.
Marek, Can you please provide more information about what needs to be added the guide for this bug?
We had in original issue 855948, which this issue is cloned from the following RN text: "Programmatic API mapping does not recognize Hibernate Search fields inherited from parent entities annotated with @MappedSuperclass. As a consequence, Hibernate Search views the fields as unmapped, resulting in a SearchException. This is not considered a bug, but a by-design behaviour that can only be addressed by a functionality enhancement. Until the functionality is enhanced, the issue can be worked around by overriding the getter methods of the inherited fields in the child entities." That should be added somewhere in HSearch Guide, but you probably need some guidance from HSearch team to confirm the chapter/section placement.
I am planning to add the following warning message above 'Example 4.17' in the HSerach guide: Warning: Programmatic API mapping does not recognize Hibernate Search fields inherited from parent entities annotated with @MappedSuperclass. As a consequence, Hibernate Search views the fields as unmapped, resulting in a SearchException. This behaviour is due to the design of the application. To work around the exception, override the getter methods of the inherited fields in the child entities. Sanne, please confirm.
I've created a JIRA to clarify the documentation: https://hibernate.atlassian.net/browse/HSEARCH-1352 Proposed fix is sent as pull request.
Sneha: sorry was working on the same in parallel, and provided a simplified wording version. I'm not sure what 'Example 4.17' means: in the community documentation that one is very unrelated so I assume the numbering is different.
We merged a documentation improvement upstream: https://github.com/hibernate/hibernate-search/commit/3e8f095aa8a644dd4a4ed0d07564c07514279ad3