Política de contribución

traducción: humano page_type: lcat

En esta página, se describen el modelo de administración y la política de contribución de Bazel.

Modelo de administración

Google dirige y administra el proyecto de Bazel, que cuenta con una gran comunidad de colaboradores fuera de Google. Los miembros de la comunidad dirigen, mantienen y administran algunos componentes de Bazel (como los repositorios de reglas específicos de la organización bazelbuild). El equipo de Google Bazel revisa las sugerencias para agregar repositorios pertenecientes a la comunidad (como reglas) a la organización de GitHub bazelbuild.

Funciones de colaborador

A continuación, se describen las funciones en el proyecto de Bazel, incluidas sus responsabilidades:

  • Propietarios: El equipo de Google Bazel Los propietarios son responsables de lo siguiente:
    • Estrategia, mantenimiento y liderazgo del proyecto de Bazel.
    • Cómo compilar y mantener la funcionalidad principal de Bazel.
    • Designar encargados de mantenimiento y aprobar repositorios nuevos
  • Encargados de mantenimiento: El equipo de Google Bazel y los usuarios designados de GitHub. Los encargados de mantenimiento son responsables de lo siguiente:
    • Compilar y mantener la funcionalidad principal de su repositorio
    • Revisar y aprobar contribuciones a áreas de la base de código de Bazel
    • Ayudar a los usuarios y colaboradores con una administración de problemas oportuna y transparente, revisión de RR.PP. y documentación
    • Lanzamiento, prueba y colaboración con propietarios de Bazel.
  • Colaboradores: Todos los usuarios que contribuyen con código o documentación al proyecto de Bazel.
    • Crear PR bien escritos para contribuir a la base de código y a la documentación de Bazel
    • Usar canales estándar, como Problemas de GitHub, para proponer cambios y, también, informar problemas

Convertirse en encargado de mantenimiento

Los propietarios de Bazel pueden designar encargados de mantenimiento para que dirijan áreas de código bien definidas, como los conjuntos de reglas. Los colaboradores con un registro de contribuciones pasadas coherentes y responsables y que planifican contribuciones importantes en el futuro podrían considerarse como encargados de mantenimiento calificados.

Política de contribución

El proyecto de Bazel acepta contribuciones de colaboradores externos. Estas son las políticas de contribución para las áreas de código administradas por Google y por la comunidad.

  • Licencias. Todos los Encargados de mantener y Colaboradores deben firmar el Contrato de Licencia para Colaboradores de Google.
  • Contribuciones. Los propietarios y encargados de mantenimiento deben hacer todo lo posible para aceptar contribuciones valiosas. Todas las contribuciones deben cumplir con los siguientes requisitos:
    • Bien redactado y bien probado
    • Se debate y aprueba por los encargados de mantenimiento del área de código relevante. Los debates y las aprobaciones se realizan en los problemas de GitHub y en los PR de GitHub. Las contribuciones más grandes requieren una revisión del diseño.
    • Se agregó al sistema de integración continua de Bazel si aún no está presente.
    • Admitible y alineado con la dirección de productos de Bazel
  • Revisión del código Todos los cambios en todos los repositorios bazelbuild requieren revisión:
    • Todas las PR deben ser aprobadas por un propietario o encargado de mantenimiento.
    • Solo los propietarios y encargados de mantenimiento pueden combinar las PR.
  • Compatibilidad. Es posible que los propietarios deban rechazar o solicitar modificaciones a los PR en el caso improbable de que el cambio requiera modificaciones sustanciales a los sistemas internos de Google.
  • Documentación: Cuando corresponda, las contribuciones de funciones deben incluir actualizaciones de la documentación.

Para obtener más detalles sobre cómo contribuir a Bazel, consulta nuestros lineamientos de contribución.