En esta página, se describe cómo los colaboradores pueden proponer y realizar cambios en la base de código de Bazel.
- Lee la política de contribución de Bazel.
- Crea un problema de GitHub para analizar tu plan y diseño. Las solicitudes de extracción que cambian o agregan comportamiento necesitan un problema correspondiente para el seguimiento.
- Si propones cambios significativos, escribe un documento de diseño.
- Asegúrate de haber firmado un Contrato de Licencia para Colaboradores.
- Prepara una confirmación de Git que implemente la función. No olvides agregar pruebas y actualizar la documentación. Si el cambio tiene efectos visibles para el usuario, agrega notas de la versión. Si es un cambio incompatible, lee la guía para lanzar cambios rotundos.
- Crea una solicitud de extracción en GitHub. Si eres nuevo en GitHub, consulta acerca de las solicitudes de extracción. Ten en cuenta que restringimos los permisos para crear ramas en el repositorio principal de Bazel, por lo que deberás enviar la confirmación a tu propia bifurcación del repositorio.
- Un encargado de mantenimiento de Bazel debería asignarte un revisor en un plazo de dos días hábiles (excepto los feriados en EE.UU. y Alemania). Si no se te asigna un revisor en ese tiempo, puedes solicitar uno por correo electrónico a bazel-dev@googlegroups.com.
- Trabaja con el revisor para completar una revisión de código. Para cada cambio, crea una confirmación nueva y envíala para que realice cambios en tu solicitud de extracción. Si la revisión lleva demasiado tiempo (por ejemplo, si el revisor no responde), envía un correo electrónico a bazel-dev@googlegroups.com.
Una vez que se completa la revisión, un encargado de mantenimiento de Bazel aplica tu parche al sistema de control de versión interno de Google.
Esto activa verificaciones internas del envío previo que podrían sugerir más cambios. Si no expresaste una preferencia, la persona que mantiene el cambio que envía el cambio agrega cambios "triviales" (como ejecución con lint) que no afectan el diseño. Si se requieren cambios más profundos o si prefieres aplicarlos directamente, tú y el revisor deben comunicar las preferencias con claridad en los comentarios de la opinión.
Después del envío interno, el parche se exporta como una confirmación de Git y, luego, se cierra la solicitud de extracción de GitHub. Todos los cambios finales se te atribuyen a ti.