ドキュメントでは、推奨ルールのリストを提供しています。
これはユーザーに優れたエクスペリエンスを提供する、質の高い一連のルールです。Google では、サポートされているルールと、インターネットで確認できる何百ものルールを区別しています。
推薦
ルールセットが以下の要件を満たしている場合、ルールの管理者は GitHub の問題を提出して、推奨ルールに含めるようにルールセットを指定できます。
Bazel コアチームによる審査後、Bazel ウェブサイトで推奨されます。
ルールのメンテナンス担当者の要件
- ルールセットは、多くの Bazel ユーザーに役立つ重要な機能(広く普及している言語のサポートなど)を提供します。
- ルールセットが十分に管理されている。アクティブなメンテナンス担当者が少なくとも 2 名必要です。
- ルールセットは詳細にドキュメント化されており、例も含まれており、簡単に使用できます。
- ルールセットはベスト プラクティスに従っており、高パフォーマンスです(パフォーマンス ガイドをご覧ください)。
- ルールセットに十分なテスト カバレッジがある。
- ルールセットは、最新バージョンの Bazel を使用して BuildKite でテストされています。テストは常に合格する必要があります(presubmit チェックとして使用する場合)。
- ルールセットは、今後予定されている互換性のない変更についてもテストされます。不具合は 2 週間以内に修正される予定です。移行に関する問題は、すぐに Bazel チームに報告する必要があります。
Bazel デベロッパーの要件
- 推奨ルールは、Bazel で頻繁にテストされます(少なくとも 1 日に 1 回)。
- Bazel を変更しても、(デフォルトのフラグセットによる)推奨ルールに違反する可能性があります。発生した場合は、変更を修正するか、ロールバックする必要があります。
降格
特定のルールセットが要件を満たさなくなった懸念がある場合は、GitHub の問題を報告してください。
ルールの管理者には連絡があり、2 週間以内に回答する必要があります。その結果に基づいて、Bazel コアチームはルールセットの降格を決定する可能性があります。