[hibernate-dev] [Search] Deprecating the @Key annotation

Gunnar made a nice patch[1] to simplify usage of parameterized, cacheable FulltextFilters: these no longer require the user to create a custom key to identify the parameterset. Documentation wise, we're struggling in finding a good explanation on why someone might want to still use the @Key annotation - besides backward compatibility. It would be nice to simply remove the references to @Key in the documentation, and avoid trying to explain when to choose between the two alternatives. This would imply to deprecate the annotation.. any objection? Sanne 1 - https://github.com/hibernate/hibernate-search/pull/775