Existen muchas formas de ayudar al proyecto y al ecosistema de Bazel.
Cómo enviar comentarios
A medida que uses Bazel, es posible que encuentres aspectos que puedes mejorar. Para ayudar, puedes informar problemas en los siguientes casos:
- Bazel falla o encuentras un error que solo se puede resolver con
bazel clean
. - La documentación está incompleta o no es clara. También puedes informar problemas desde la página que estás viendo mediante el vínculo “Crear problema” que aparece en la esquina superior derecha de la página.
- Se podría mejorar un mensaje de error.
Participa en la comunidad
Puedes interactuar con la comunidad de Bazel de las siguientes maneras:
- Responder preguntas en Stack Overflow.
- Cómo ayudar a otros usuarios en Slack
- Mejorar la documentación o contribuir con ejemplos
- Compartir tu experiencia o tus sugerencias, por ejemplo, en un blog o en redes sociales
Contribuir con código
Bazel es un proyecto grande, por lo que puede ser difícil hacer un cambio en el código fuente de Bazel.
Puedes contribuir al ecosistema de Bazel de las siguientes maneras:
- Ayudar a los encargados de mantener las reglas mediante contribuciones de solicitudes de extracción.
- Crear reglas nuevas y ponerlas en código abierto
- Contribuye a las herramientas relacionadas con Bazel, por ejemplo, herramientas de migración.
- Mejoramos la integración de Bazel con otros IDE y herramientas.
Antes de realizar un cambio, crea un problema de GitHub o envía un correo electrónico a bazel-evaluate@.
Las contribuciones más útiles corrigen errores o agregan funciones (a diferencia de los cambios de estilo, la refactorización o la "limpieza"). El cambio debe incluir pruebas y documentación, teniendo en cuenta la retrocompatibilidad, la portabilidad y el impacto en el uso y el rendimiento de la memoria.
Para obtener más información sobre cómo enviar un cambio, consulta el proceso de aceptación de parches.
Descripción del código de Bazel
Bazel tiene una gran base de código con código en varias ubicaciones. Consulta la guía de la base de código para obtener más detalles.
Bazel se organiza de la siguiente manera:
- El código del cliente se encuentra en
src/main/cpp
y proporciona la interfaz de línea de comandos. - Los búferes de protocolo están en
src/main/protobuf
. - El código del servidor se encuentra en
src/main/java
ysrc/test/java
.- Código principal que se compone principalmente de SkyFrame y algunas utilidades.
- Las reglas integradas están en
com.google.devtools.build.lib.rules
y encom.google.devtools.build.lib.bazel.rules
. Te recomendamos que primero leas los Desafíos de las reglas de escritura.
- Las interfaces nativas de Java están en
src/main/native
. - En la lista de la sección Compila Bazel, se describen diversas herramientas para admitir los lenguajes.
Busca el código fuente de Bazel
Para buscar rápidamente el código fuente de Bazel, usa la Búsqueda de código fuente de Bazel. Puedes explorar los repositorios, las ramas y los archivos de Bazel. También puedes ver el historial, las diferencias y la información de la culpa. Para obtener más información, consulta la Guía del usuario de la búsqueda de código de Bazel.