推奨ルール

問題を報告 ソースを表示 毎晩

ドキュメントでは、推奨ルールのリストを提供しています。

これはユーザーに優れたエクスペリエンスを提供する、質の高い一連のルールです。Google では、サポートされているルールと、インターネットで確認できる何百ものルールを区別しています。

推薦

ルールセットが以下の要件を満たしている場合、ルールの管理者は GitHub の問題を提出して、推奨ルールに含めるようにルールセットを指定できます。

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

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

  • ルールセットは、多くの Bazel ユーザーに役立つ重要な機能(広く普及している言語のサポートなど)を提供します。
  • ルールセットが十分に管理されている。アクティブなメンテナンス担当者が少なくとも 2 名必要です。
  • ルールセットは詳細にドキュメント化されており、例も含まれており、簡単に使用できます。
  • ルールセットはベスト プラクティスに従っており、高パフォーマンスです(パフォーマンス ガイドをご覧ください)。
  • ルールセットに十分なテスト カバレッジがある。
  • ルールセットは、最新バージョンの Bazel を使用して BuildKite でテストされています。テストは常に合格する必要があります(presubmit チェックとして使用する場合)。
  • ルールセットは、今後予定されている互換性のない変更についてもテストされます。不具合は 2 週間以内に修正される予定です。移行に関する問題は、すぐに Bazel チームに報告する必要があります。

Bazel デベロッパーの要件

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

降格

特定のルールセットが要件を満たさなくなった懸念がある場合は、GitHub の問題を報告してください。

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