推奨ルール

問題を報告 ソースを表示 ナイトリー · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

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

推薦

ルールセットが以下の要件を満たしている場合、ルールのメンテナンス担当者は GitHub の問題を報告して、そのルールセットを推奨ルールに登録するよう申請できます。

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

ルールのメンテナンス担当者の要件

  • このルールセットには、多くの Bazel ユーザーに役立つ重要な機能(広く使用されている言語のサポートなど)が用意されています。
  • ルールセットは適切に維持されている。少なくとも 2 人のアクティブなメンテナーが必要です。
  • ルールセットはドキュメントが充実しており、例も豊富で使いやすい。
  • ルールセットがベスト プラクティスに準拠しており、パフォーマンスが高い(パフォーマンス ガイドをご覧ください)。
  • ルールセットに十分なテスト範囲がある。
  • このルールセットは、最新バージョンの Bazel を使用して BuildKite でテストされています。テストは常に合格する必要があります(送信前チェックとして使用する場合)。
  • ルールセットは、今後の互換性のない変更でもテストされます。不具合は 2 週間以内に修正される予定です。移行に関する問題は、すぐに Bazel チームに報告する必要があります。

Bazel デベロッパーの要件

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

降格

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

ルールのメンテナンス担当者に連絡が届き、2 週間以内に返信する必要があります。結果に基づいて、Bazel コアチームはルールセットを降格させる決定を行う場合があります。