推奨ルール

問題を報告する ソースを表示 Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

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

推薦

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

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

ルール管理者の要件

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

Bazel デベロッパーの要件

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

降格

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

ルール管理者に連絡が届きます。2 週間以内に対応する必要があります。結果に基づいて、Bazel コアチームがルールセットの降格を決定する可能性があります。