Política de contribución

traducción: human page_type: lcat

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

Modelo de administración

Google dirige y administra el proyecto Bazel y tiene una gran comunidad de colaboradores ajenos a Google. Los miembros de la comunidad dirigen, mantienen y administran algunos componentes de Bazel (como los repositorios de reglas específicos en 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 bazelbuild de GitHub.

Funciones de los colaboradores

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

• Propietarios: Es el equipo de Google Bazel. Los propietarios son responsables de lo siguiente:
  • Estrategia, mantenimiento y liderazgo del proyecto Bazel.
  • Compilación y mantenimiento de 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 en áreas de la base de código de Bazel
  • Asistir a usuarios y colaboradores en la administración de problemas, la revisión de RR.PP. y la documentación de forma oportuna y transparente.
  • Lanzamiento, prueba y colaboración con los propietarios de Bazel.
• Colaboradores: Todos los usuarios que aportan 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 los 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 conjuntos de reglas. Los colaboradores con un registro de contribuciones pasadas coherentes y responsables que planifican contribuciones importantes en el futuro podrían considerarse encargados de mantenimiento calificados.

Política de contribución

El proyecto de Bazel acepta contribuciones de colaboradores externos. A continuación, se incluyen las políticas de contribución para las áreas de código administradas por Google y por la comunidad.

• Licencias. Todos los encargados de mantenimiento y Colaboradores deben firmar el Contrato de Licencia para Colaboradores de Google.
• Contribuciones. Los propietarios y encargados de mantenimiento deben hacer todo lo posible por aceptar contribuciones valiosas. Todas las contribuciones deben cumplir con los siguientes requisitos:
  • Bien redactado y bien probado
  • Los encargados del mantenimiento del área de código relevante deben analizarlos y aprobarlos. Los debates y las aprobaciones tienen lugar en los problemas de GitHub y en los PR de GitHub. Las contribuciones de mayor tamaño requieren una revisión del diseño.
  • Se agregó al sistema de integración continua de Bazel si aún no está presente.
  • Son compatibles y alineados con la dirección de productos de Bazel.
• Revisión de código. Todos los cambios en todos los repositorios bazelbuild requieren revisión:
  • Todos los PR deben ser aprobados por un propietario o encargado de mantenimiento.
  • Solo los propietarios y encargados de mantener las relaciones pueden combinar las relaciones públicas.
• Compatibilidad. Es posible que los propietarios deban rechazar los PR o solicitar modificaciones en ellos en el improbable caso de que el cambio requiera modificaciones importantes en 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.