Create an @EndOfLife corollary to @Incubating

Description

Acts as a supplement to @Deprecated. The idea is that we'd add this whenever we knew that a certain method/interface/class is going to be going away.

This is intended to appease the people who argue that adding deprecation before we have the alternative in place is a hard thing to deal with as they cannot fix those deprecation errors.

I'd love to see something like:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 public interface @EndOfLife { enum Version { UNKNOWN, 3, 4_0, 4_1, 4_2, ... 5_0, 6_0 } String description(); Version asOf(); Version removal() default UNKNOWN; }

Environment

None

Status

Assignee

Unassigned

Reporter

Steve Ebersole

Fix versions

Labels

None

backPortable

None

Suitable for new contributors

None

Requires Release Note

None

Pull Request

None

backportDecision

None

Priority

Major