En la documentación, proporcionamos una lista de reglas recomendadas.
Este es un conjunto de reglas de alta calidad que proporcionarán una buena experiencia a nuestros usuarios. Hacemos una distinción entre las reglas compatibles y los cientos de reglas que puedes encontrar en Internet.
Nominación
Si un conjunto de reglas cumple con los requisitos que se indican a continuación, un mantenedor de reglas puede nominarlo para que forme parte de las reglas recomendadas informando un problema en GitHub.
Después de una revisión por parte del equipo principal de Bazel, se recomendará en el sitio web de Bazel.
Requisitos para los mantenedores de reglas
- El conjunto de reglas proporciona una función importante, útil para una gran cantidad de usuarios de Bazel (por ejemplo, compatibilidad con un lenguaje muy popular).
- El conjunto de reglas está bien mantenido. Debe haber al menos dos mantenedores activos.
- El conjunto de reglas está bien documentado, con ejemplos y es fácil de usar.
- El conjunto de reglas sigue las prácticas recomendadas y es eficaz (consulta la guía de rendimiento).
- El conjunto de reglas tiene una cobertura de prueba suficiente.
- El conjunto de reglas se prueba en BuildKite con la versión más reciente de Bazel. Las pruebas siempre deben aprobarse (cuando se usan como una verificación previa a la confirmación).
- El conjunto de reglas también se prueba con los próximos cambios incompatibles. Las interrupciones deben corregirse en un plazo de dos semanas. Los problemas de migración deben informarse al equipo de Bazel con rapidez.
Requisitos para los desarrolladores de Bazel
- Las reglas recomendadas se prueban con frecuencia con Bazel en el encabezado (al menos una vez al día).
- Ningún cambio en Bazel puede interrumpir una regla recomendada (con el conjunto predeterminado de marcas). Si sucede, el cambio debe corregirse o revertirse.
Descensos de nivel
Si existe la preocupación de que un conjunto de reglas en particular ya no cumpla con los requisitos, se debe informar un problema en GitHub.
Se comunicarán con los mantenedores de reglas, quienes deberán responder en un plazo de 2 semanas. Según el resultado, el equipo principal de Bazel podría tomar la decisión de degradar el conjunto de reglas.