推奨ルール

問題を報告する ソースを表示

このドキュメントでは、推奨ルールの一覧を示します。

これは一連の高品質なルールで、ユーザーに優れたエクスペリエンスを提供します。Google では、サポートされるルールと、インターネット上にある数百のルールを区別しています。

推薦

ルールセットが以下の要件を満たしている場合、ルールメンテナーは GitHub の問題を提出することで、そのルールセットを推奨ルールの一部に指定できます。

Bazel コアチームによる審査が完了すると、Bazel のウェブサイトで推奨されます。

ルールメンテナーの要件

  • このルールセットは、多数の Bazel ユーザーに有用な機能を備えています(たとえば、広く使われている言語のサポートなど)。
  • ルールセットは適切に保守されています。有効なメンテナーが 2 つ以上必要です。
  • ルールセットは詳細に説明され、例が含まれ、使いやすい。
  • ルールセットはベスト プラクティスに従っており、パフォーマンスに優れています(パフォーマンス ガイドを参照)。
  • このルールセットに十分なテスト カバレッジがあります。
  • ルールセットは、最新バージョンの Bazel を使用して Bazel でテストされています。テストは常に合格する必要があります(presubmit チェックとして使用されている場合)。
  • また、互換性のない変更でルールセットもテストされます。破損は 2 週間以内に修正されます。移行に関する問題は、Bazel チームに速やかに報告してください。

Bazel デベロッパーの要件

  • 推奨されるルールは、Bazel で(1 日に 1 回以上)頻繁にテストされます。
  • デフォルトのフラグセットを使用すると、Bazel で推奨ルールが破損することはありません。その場合、変更を修正するか、ロールバックする必要があります。

順位を下げる

特定のルールセットが要件を満たさなくなったと思われる場合は、GitHub の問題を提出してください。

ルールの管理者に連絡し、2 週間以内に返信する必要があります。結果に基づき、Bazel のコアチームがルールセットの順位を下げるかどうかを決定することがあります。