非推奨用語
非推奨
- 機能のサポートを終了したり、機能を削除したりする前に必要です。
- 使用を推奨しない機能
- 開発者は優先度 1 / 重大度 1 のバグ修正に限定されます。
- 将来のメジャーリリースで削除される予定です。
- サポート終了日または削除日の概要を示す非推奨のアナウンス後に開始されます。
- サポート終了日または撤去日が過ぎたら終了。
サポート終了
- 取り外し前のオプションステップ。
- この機能の使用は強く推奨されません。
- サポートや修正は提供されません。
- 内部でのテストは終了しています。
- 将来のメジャーリリースで削除される予定です。
- サポート終了日が過ぎた後に開始されます。
サポート終了のアナウンスは特別な状況でのみ使用されるべきで、一般的な使用は推奨されません。ほとんどの機能は非推奨となり、その後削除されるべきです。
削除
- 機能使用不可。
- サポートが終了した機能(サポート終了が発表されていない場合)。
- セマンティックバージョニングポリシーに沿ったメジャーリリースで発生します。
- 削除日が過ぎた後に開始されます。
変更
ブレークチェンジ “とは、ユーザーがコードや設定、ワークフローを変更しなければならないような変更のことです。「ユーザー “は人間、APIクライアント、あるいは別のクラスを “使用する “コードクラスかもしれません。ブレークチェンジの例としては、以下のようなものがあります:
- 代替/回避策なしにユーザー向けの機能を削除すること。
- 既存のAPIの定義の変更(クエリパラメータの名前の変更やルートの変更など)。
- コードクラスから公開メソッドを削除すること。
破壊的な変更は、それが多くのユーザーに影響を与えるか、動作の重大な変更を表す場合、主要な変更と見なされます。