ドキュメントには、推奨されるルールのリストが記載されています。
これは、ユーザーに優れたエクスペリエンスを提供する高品質なルールのセットです。Google は、サポートされているルールと、インターネットで見つけることができる数百のルールを区別しています。
推薦
ルールセットが以下の要件を満たしている場合、ルールのメンテナンス担当者は GitHub の問題を報告して、そのルールセットを推奨ルールに登録するよう申請できます。
Bazel コアチームによる審査の後、Bazel ウェブサイトで推奨されます。
ルールのメンテナンス担当者の要件
- このルールセットには、多くの Bazel ユーザーに役立つ重要な機能(広く使用されている言語のサポートなど)が用意されています。
- ルールセットは適切に維持されている。少なくとも 2 人のアクティブなメンテナーが必要です。
- ルールセットはドキュメントが充実しており、例も豊富で使いやすい。
- ルールセットがベスト プラクティスに準拠しており、パフォーマンスが高い(パフォーマンス ガイドをご覧ください)。
- ルールセットに十分なテスト範囲がある。
- このルールセットは、最新バージョンの Bazel を使用して BuildKite でテストされています。テストは常に合格する必要があります(送信前チェックとして使用する場合)。
- ルールセットは、今後の互換性のない変更でもテストされます。不具合は 2 週間以内に修正される予定です。移行に関する問題は、すぐに Bazel チームに報告する必要があります。
Bazel デベロッパーの要件
- 推奨ルールは、Bazel のヘッドで頻繁にテストされます(少なくとも 1 日に 1 回)。
- Bazel を変更しなくても、推奨ルール(デフォルトのフラグセットを使用)が破られる可能性があります。そのような場合は、変更を修正するかロールバックする必要があります。
降格
特定のルールセットが要件を満たしていないと思われる場合は、GitHub の問題を報告する必要があります。
ルールのメンテナンス担当者に連絡が届き、2 週間以内に返信する必要があります。結果に基づいて、Bazel コアチームはルールセットを降格させる決定を行う場合があります。