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

[Sanne Grinovero]

On 29 January 2015 at 16:25, Gunnar Morling <gunnar at hibernate.org> wrote:
> 2015-01-29 9:42 GMT+01:00 Hardy Ferentschik <hardy at hibernate.org>:
>>
>> Hi,
>>
>> > 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?
>>
>> +1 for not mentioning it in the docs. Not sure whether this implies that
>> we need to deprecate it as well, but I have no hard feelings if we do.
>
>
> I wouldn't like to remove it from the docs without deprecating it. It'd
> appear as if a) we'd have forgotten to document this stuff or b) it's stuff
> where no-one knows it's there and whether it works or not.
>
> My vote goes for doc removal + deprecation in 5.1., followed by the removal
> in 5.2 / 6 (depending on what the project guideline for this sort of change
> is).

+1, let's say we remove it in 6.. that can be adjusted if need be.

Sanne

>
>>
>> --Hardy
>>
>> _______________________________________________
>> hibernate-dev mailing list
>> hibernate-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/hibernate-dev
>
>