メインコンテンツにスキップ

ルールの廃止、名前の変更、および削除

かつて👍だったルールが、時とともに👎となる場合があります。過去には、次のようなケースがありました。

  • 普遍的なベストプラクティスを表していない、過度に意見の強い、またはスタイル的なルール
  • 名前変更
  • 外部プラグインに移動されたルール

このような場合、ユーザーへの混乱を最小限に抑えて古いルールを削除することを目指します。

Issueの提出

ルールの廃止および名前変更は、テンプレートを使用しない新しいIssueとして提出できます。

## 概要に以下の内容を記載してください。

  • ルール名とドキュメントページへのリンク
  • 廃止または名前変更すべきだと考える理由を明確に説明してください
  • eslint-config-airbnb-typescripteslint-config-standard-with-typescriptなど、一般的な設定に存在するかどうか
  • ユーザー設定にどれくらいの頻度で出現するかを示すSourcegraphクエリ

これらのリンクとクエリの例については、#6036を参照してください。

タイムライン

  1. 任意のマイナー/パッチバージョンで、ルールmetaプロパティを追加します。
    • deprecated: true
    • 該当する場合、replacedBy
  2. 未解決のIssueとPRを検索し、それに応じて名前を更新します
    • 削除:Issueと廃止PRへのリンクを付けて閉じます
    • 名前変更:タイトルを更新し、ルール名が変更されたことをコメントで明示的に記述します
  3. 次のメジャーバージョンでは、廃止されたルールを削除できます
    • 新しい関連ルールまたはドキュメントを指す墓石としてドキュメントページを残します(例としてcamelcaseを参照)