Our documentation should outline contexts (Mapping-metadata, Query annotations), explain module limitations See also https://github.com/spring-projects/spring-data-jpa/issues/3688