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