As shown by the very existence of HSEARCH-2367 Pull Request Sent , QueryDescriptor (returned by ElasticsearchQueries in particular) may prove confusing.

We should ensure there's a clear documentation about how to use this class (i.e. org.hibernate.search.FullTextSession.createFullTextQuery(QueryDescriptor, Class<?>...)), and that everywhere we return such an object, we add a link pointing to this documentation.