推奨ルール

ドキュメントには、 推奨されるルールのリストが記載されています。

これは高品質なルールのセットであり、ユーザーに優れたエクスペリエンスを提供します。サポートされているルールと、インターネットで見つかる数百ものルールは区別されます。

推薦

ルールセットが以下の要件を満たしている場合、ルールのメンテナーは 推奨ルールの一部として、 GitHub の問題を報告して、ルールセットを推薦できます。

Bazel コアチームによるレビューの後、Bazel ウェブサイトで推奨されます。

ルールのメンテナーの要件

  • ルールセットは、多くの Bazel ユーザーにとって役立つ重要な機能を提供します(広く普及している言語のサポートなど)。
  • ルールセットは適切に管理されています。アクティブなメンテナーが 2 人以上必要です。
  • ルールセットはドキュメントが充実しており、例が記載されていて使いやすいです。
  • ルールセットはベスト プラクティスに準拠しており、パフォーマンスに優れています( パフォーマンス ガイドをご覧ください)。
  • ルールセットのテスト カバレッジは十分です。
  • ルールセットは、 BuildKite 最新バージョンの Bazel を使用してテストされています。(プリサブミット チェックとして使用する場合は)テストに常に合格する必要があります。
  • ルールセットは、今後の互換性のない変更でもテストされます。破損は 2 週間以内に修正する必要があります。移行に関する問題は、Bazel チームに迅速に報告する必要があります。

Bazel デベロッパーの要件

  • 推奨ルールは、Bazel のヘッドで頻繁にテストされます(少なくとも 1 日 1 回)。
  • Bazel の変更によって推奨ルールが破損することはありません(デフォルトのフラグセットを使用)。破損した場合は、変更を修正またはロールバックする必要があります。

格下げ

特定のルールセットが要件を満たしていないと思われる場合は、GitHub の問題を報告する必要があります。

ルールのメンテナーに連絡が届きます。2 週間以内に対応する必要があります。結果に基づいて、Bazel コアチームがルールセットの格下げを決定する場合があります。