En la documentación, proporcionamos una lista de reglas recomendadas.
Se trata de un conjunto de reglas de alta calidad que ofrecerán una buena experiencia a nuestros usuarios. Hacemos una distinción entre las reglas admitidas y los cientos de que puedes encontrar en Internet.
Nominación
Si un conjunto de reglas cumple con los requisitos que se indican a continuación, el encargado de mantenimiento de las reglas puede nominarlo para que forme parte de las reglas recomendadas. Para ello, envíe un Problema de GitHub.
Después de la revisión del equipo principal de Bazel, en el sitio web de Bazel.
Requisitos para los encargados de mantener reglas
- El conjunto de reglas proporciona una función importante que es útil para muchos proveedores de Bazel. (por ejemplo, compatibilidad con un idioma ampliamente popular).
- El conjunto de reglas se mantiene en buen estado. Debe haber al menos dos encargados de mantenimiento 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 tiene un buen rendimiento (consulta la guía de rendimiento).
- El conjunto de reglas tiene suficiente cobertura de prueba.
- El conjunto de reglas se prueba BuildKite con la versión más reciente de Bazel. Las pruebas siempre deben ser exitosas (cuando se usan verificación previa al envío).
- El conjunto de reglas también se prueba con los próximos cambios incompatibles. Fallas debería corregirse en un plazo de dos semanas. Los problemas de migración deben informarse al al equipo de Bazel.
Requisitos para desarrolladores de Bazel
- Las reglas recomendadas se prueban frecuentemente con Bazel al principio (al menos una vez al día).
- Ningún cambio en Bazel podría infringir una regla recomendada (con el conjunto predeterminado de marcas). Si ocurre, el cambio debe corregirse o revertirse.
Descenso de nivel
Si te preocupa que un conjunto de reglas en particular ya no cumpla con el , debería plantearse un problema de GitHub archivado.
Se comunicará con los encargados de mantener las reglas, quienes deberán responder en 2 semanas. Según el como resultado, el equipo principal de Bazel podría tomar la decisión de descender de nivel el conjunto de reglas.