Hay muchas formas de ayudar al proyecto y al ecosistema de Bazel.
Proporcionar comentarios
A medida que uses Bazel, es posible que encuentres cosas que se puedan mejorar. Puedes ayudar informando 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 con el vínculo "Crear problema" que se encuentra 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:
- Responde preguntas en Stack Overflow.
- Ayudar a otros usuarios en Slack
- Mejorar la documentación o aportar ejemplos
- Compartir tu experiencia o tus sugerencias, por ejemplo, en un blog o en redes sociales
Contribuye con código
Bazel es un proyecto grande, y hacer un cambio en el código fuente de Bazel puede ser difícil.
Puedes contribuir al ecosistema de Bazel de las siguientes maneras:
- Ayudar a los mantenedores de reglas con contribuciones de solicitudes de extracción
- Crear reglas nuevas y publicarlas como código abierto
- Contribuir a herramientas relacionadas con Bazel, por ejemplo, herramientas de migración
- Mejorar 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-discuss@.
Las contribuciones más útiles corrigen errores o agregan funciones (a diferencia de los cambios de estilo, refactorización o "limpieza"). El cambio debe incluir pruebas y documentación, y tener en cuenta la retrocompatibilidad, la portabilidad y el impacto en el uso de la memoria y el rendimiento.
Para obtener 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/cppy proporciona la interfaz de línea de comandos. - Los búferes de protocolo se encuentran en
src/main/protobuf. - El código del servidor se encuentra en
src/main/javaysrc/test/java.- Código principal que se compone principalmente de SkyFrame y algunas utilidades.
- Las reglas integradas se encuentran en
com.google.devtools.build.lib.rulesy encom.google.devtools.build.lib.bazel.rules. Te recomendamos que primero leas sobre los desafíos de escribir reglas.
- Las interfaces nativas de Java se encuentran en
src/main/native. - En la lista de la sección Compilación de Bazel, se describen varias herramientas para la compatibilidad con idiomas.
Cómo buscar en el código fuente de Bazel
Para buscar rápidamente en el código fuente de Bazel, usa Bazel Code Search. Puedes navegar por los repositorios, las ramas y los archivos de Bazel. También puedes ver el historial, las diferencias y la información de blame. Para obtener más información, consulta la Guía del usuario de Bazel Code Search.