このドキュメントでは、推奨ルールの一覧を示します。
これは一連の高品質なルールで、ユーザーに優れたエクスペリエンスを提供します。Google では、サポートされるルールと、インターネット上にある数百のルールを区別しています。
推薦
ルールセットが以下の要件を満たしている場合、ルールメンテナーは GitHub の問題を提出することで、そのルールセットを推奨ルールの一部に指定できます。
Bazel コアチームによる審査が完了すると、Bazel のウェブサイトで推奨されます。
ルールメンテナーの要件
- このルールセットは、多数の Bazel ユーザーに有用な機能を備えています(たとえば、広く使われている言語のサポートなど)。
- ルールセットは適切に保守されています。有効なメンテナーが 2 つ以上必要です。
- ルールセットは詳細に説明され、例が含まれ、使いやすい。
- ルールセットはベスト プラクティスに従っており、パフォーマンスに優れています(パフォーマンス ガイドを参照)。
- このルールセットに十分なテスト カバレッジがあります。
- ルールセットは、最新バージョンの Bazel を使用して Bazel でテストされています。テストは常に合格する必要があります(presubmit チェックとして使用されている場合)。
- また、互換性のない変更でルールセットもテストされます。破損は 2 週間以内に修正されます。移行に関する問題は、Bazel チームに速やかに報告してください。
Bazel デベロッパーの要件
- 推奨されるルールは、Bazel で(1 日に 1 回以上)頻繁にテストされます。
- デフォルトのフラグセットを使用すると、Bazel で推奨ルールが破損することはありません。その場合、変更を修正するか、ロールバックする必要があります。
順位を下げる
特定のルールセットが要件を満たさなくなったと思われる場合は、GitHub の問題を提出してください。
ルールの管理者に連絡し、2 週間以内に返信する必要があります。結果に基づき、Bazel のコアチームがルールセットの順位を下げるかどうかを決定することがあります。