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

[Sanne Grinovero]

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