ドキュメントには、推奨されるルールのリストが記載されています。
これは、ユーザーに優れたエクスペリエンスを提供するための高品質なルールのセットです。サポートされているルールと、インターネットで見つかる数百ものルールは区別されます。
推薦
ルールセットが以下の要件を満たしている場合、ルール メンテナーは GitHub の問題を報告して、ルールセットを推奨ルールの一部として推薦できます。
Bazel コアチームによるレビューの後、Bazel ウェブサイトで推奨されます。
ルール管理者の要件
- ルールセットは、多くの Bazel ユーザーにとって有用な重要な機能(広く普及している言語のサポートなど)を提供します。
- ルールセットは適切に管理されています。アクティブなメンテナーが 2 人以上必要です。
- ルールセットはドキュメントが充実しており、例も豊富で、使いやすいです。
- ルールセットはベスト プラクティスに準拠しており、パフォーマンスに優れています(パフォーマンス ガイドを参照)。
- ルールセットのテスト カバレッジが十分である。
- ルールセットは、最新バージョンの Bazel を使用して BuildKite でテストされます。テストは常に合格する必要があります(送信前チェックとして使用する場合)。
- ルールセットは、今後予定されている互換性のない変更についてもテストされます。破損は 2 週間以内に修正される予定です。移行に関する問題は、Bazel チームに速やかに報告する必要があります。
Bazel デベロッパーの要件
- 推奨ルールは、ヘッドで Bazel を使用して頻繁にテストされます(少なくとも 1 日 1 回)。
- Bazel の変更によって、推奨ルール(デフォルトのフラグセットを使用)が壊れることはありません。その場合は、変更を修正するかロールバックする必要があります。
降格
特定のルールセットが要件を満たしていない可能性がある場合は、GitHub の問題を報告する必要があります。
ルール管理者に連絡が届きます。2 週間以内に対応する必要があります。結果に基づいて、Bazel コアチームがルールセットの降格を決定する可能性があります。