弃用

  • 在结束对某个功能的支持或移除功能之前是必须的。
  • 不推荐使用该功能。
  • 开发仅限于优先级 1 / 严重性 1 的错误修复。
  • 将在未来的主要版本中移除。
  • 在弃用公告之后开始，该公告概述了支持结束或移除的日期。
  • 在支持结束日期或移除日期过去后结束。

支持结束

  • 移除之前的可选步骤。
  • 强烈不建议使用功能。
  • 不提供支持或修复。
  • 内部不再进行测试。
  • 将在未来的主要版本中移除。
  • 在支持结束日期过去后开始。

移除

  • 功能使用变得不可能。
  • 功能不再受支持（如果支持结束期尚未宣布）。
  • 根据我们的 语义版本控制策略 在主要版本中发生。
  • 在移除日期过去后开始。

重大变更

“重大变更”是指任何要求用户对其代码、设置或工作流进行相应变更的更改。“用户”可能是人类、API 客户端，甚至是“使用”其他类的代码类。重大变更的例子包括：

  • 移除没有替代方案/解决方法的用户界面功能。
  • 更改现有 API 的定义（通过重命名查询参数或更改路由等方式）。
  • 从代码类中移除公共方法。

如果重大变更影响许多用户，或者代表行为的显著变化，则可以被认为是重大变更。