如何处理库中的函数弃用？

我正在研究Java库,并希望从中删除一些函数.我的理由是公共API和设计清理.有些对象有setter,但应该是不可变的,某些功能已经在不同的方法中实现得更好/更清洁等等.

我已将这些方法标记为"已弃用",并希望最终将其删除.目前我正在考虑在几次冲刺(两周开发周期)后删除这些.

有关删除多余公共代码的"最佳实践"吗？

/ JaanusSiim

设置日期并在@deprecated标记中公布.删除所需的时间取决于您的代码拥有的用户数量,您与它们的连接情况以及更改的原因.

如果你有成千上万的用户,而你几乎没有与他们交谈,那么时间框架可能应该在几十年的范围内:-)

如果您的用户是您的10个同事并且您每天都看到它们,那么时间范围可以很容易地在几周内完成.

/**
 * @deprecated
 * This method will be removed after Halloween!
 * @see #newLocationForFunctionality
 */