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