En la documentación, proporcionamos una lista de reglas recomendadas.
Se trata de un conjunto de reglas de alta calidad que proporcionarán una buena experiencia a nuestros usuarios. Hacemos una distinción entre las reglas admitidas 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, el mantenedor de reglas puede nominarlo para que forme parte de las reglas recomendadas presentando un problema de GitHub.
Después de que el equipo principal de Bazel realice una revisión, 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 se mantiene en buen estado. Debe haber al menos dos mantenedores activos.
- El conjunto de reglas está bien documentado, incluye 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 en BuildKite con la versión más reciente de Bazel. Las pruebas siempre deben aprobarse (cuando se usan como una verificación previa al envío).
- El conjunto de reglas también se prueba con los próximos cambios incompatibles. Las roturas se deben reparar en un plazo de dos semanas. Los problemas de migración se deben informar al equipo de Bazel rápidamente.
Requisitos para los desarrolladores de Bazel
- Las reglas recomendadas se prueban con frecuencia con Bazel en la versión principal (al menos una vez al día).
- Ningún cambio en Bazel puede interrumpir una regla recomendada (con el conjunto predeterminado de marcas). Si esto sucede, se debe corregir o revertir el cambio.
Descenso
Si existe la preocupación de que un conjunto de reglas en particular ya no cumple con los requisitos, se debe presentar un problema de 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.