문서에는 추천 규칙 목록이 제공됩니다.
이는 사용자에게 우수한 환경을 제공하는 고품질 규칙의 집합입니다. Google에서는 지원되는 규칙과 인터넷에서 찾을 수 있는 수백 개의 규칙을 구분합니다.
수상 후보 선정
규칙 집합이 아래 요구사항을 충족하는 경우 규칙 유지자는 GitHub 문제를 제출하여 권장 규칙에 포함하도록 제안할 수 있습니다.
Bazel 핵심팀의 검토를 거친 후 Bazel 웹사이트에 권장됩니다.
규칙 유지 관리자의 요구사항
- 규칙 집합은 많은 Bazel 사용자에게 유용한 중요한 기능 (예: 널리 사용되는 언어 지원)을 제공합니다.
- 규칙 집합이 잘 관리되고 있습니다. 활성 유지보수자가 2명 이상 있어야 합니다.
- 규칙 집합은 예시와 함께 잘 문서화되어 있으며 사용하기 쉽습니다.
- 규칙 집합은 권장사항을 따르며 성능이 우수합니다 (성능 가이드 참고).
- 규칙 집합에 충분한 테스트 범위가 있습니다.
- 규칙 집합은 최신 버전의 Bazel을 사용하여 BuildKite에서 테스트됩니다. 테스트는 항상 통과해야 합니다 (사전 제출 검사로 사용되는 경우).
- 규칙 집합은 향후 호환되지 않는 변경사항으로도 테스트됩니다. 중단된 부분은 2주 이내에 해결해야 합니다. 이전 문제는 Bazel팀에 신속하게 보고해야 합니다.
Bazel 개발자 요구사항
- 권장 규칙은 Bazel의 헤드에서 자주 테스트됩니다 (하루에 한 번 이상).
- Bazel을 변경해도 기본 플래그 세트로 추천 규칙이 위반될 수 있습니다. 이 경우 변경사항을 수정하거나 롤백해야 합니다.
순위 강등
특정 규칙 집합이 더 이상 요구사항을 충족하지 않는다고 우려되는 경우 GitHub 문제를 신고해야 합니다.
규칙 유지 관리자에게 연락이 전달되며 2주 이내에 응답해야 합니다. 결과에 따라 Bazel 핵심팀에서 규칙 세트를 다운그레이드하기로 결정할 수 있습니다.