推奨ルール

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

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

推薦

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

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

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

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

Bazel デベロッパーの要件

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

格下げ

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

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