권장 규칙

문제 신고 소스 보기

이 문서에서는 권장 규칙 목록을 제공합니다.

이는 사용자에게 긍정적인 경험을 제공할 수 있게 해주는 일련의 고품질 규칙입니다. Google은 지원되는 규칙과 인터넷에서 찾을 수 있는 수백 가지 규칙을 구분합니다.

수상 후보

규칙 세트가 아래 요구사항을 충족하는 경우 GitHub 문제를 제출하여 규칙 관리자가 권장 규칙에 포함되도록 지정할 수 있습니다.

Bazel 코어팀의 검토를 완료한 후 Bazel 웹사이트에서 이를 권장합니다.

규칙 관리자 요구사항

  • 규칙 세트는 많은 Bazel 사용자에게 유용한 중요한 기능을 제공합니다 (예: 널리 사용되는 언어 지원).
  • 규칙 세트가 잘 유지관리되고 있습니다. 활성 유지 담당자가 2개 이상 있어야 합니다.
  • 규칙 세트가 문서화되고 예와 함께 사용도 간편합니다.
  • 규칙 세트가 권장사항을 따르고 성능이 우수합니다 (성능 가이드 참고).
  • 규칙 세트에 충분한 테스트 범위가 있습니다.
  • 규칙 세트는 최신 버전의 Bazel을 사용하여 BuildKite에서 테스트됩니다. 테스트는 항상 통과해야 합니다 (사전 제출 확인으로 사용되는 경우).
  • 규칙 세트는 호환되지 않는 예정된 변경사항으로도 테스트됩니다. 손상은 2주 이내에 수정되어야 합니다. 마이그레이션 문제는 Bazel팀에 신속하게 보고해야 합니다.

Bazel 개발자 요구사항

  • 권장 규칙은 Bazel을 사용하여 자주 테스트합니다 (최소 하루에 한 번).
  • Bazel을 변경해도 기본 규칙 세트와 함께 권장 규칙이 손상되지 않습니다. 이 경우 변경사항을 수정하거나 롤백해야 합니다.

변심

특정 규칙 세트가 더 이상 요구사항을 충족하지 않을까 우려되는 경우 GitHub 문제를 제출해야 합니다.

규칙 관리자에게 연락하여 2주 이내에 응답해야 합니다. 결과를 기반으로 Bazel 핵심팀에서 규칙 집합의 순위를 낮출 수 있습니다.