Guía de contribución¶
Hay muchas formas de contribuir a BeeWare completo. Estas guías cubren todo lo que necesitas saber para aportar tu contribución.
¿Qué puedo hacer?¶
Solucionar una incidencia¶
La contribución más obvia que puedes hacer es escribir código para solucionar una incidencia conocida.
Implementar una prestación nueva¶
¿Es BeeWare alguna prestación ausente que te gustaría ver? Puedes implementar una prestación nueva.
Escribir documentación¶
Ninguna prestación está completa hasta que está bien documentada. Escribir documentación es una forma de contribuir que no implica escribir código.
Triage de una incidencia¶
Cada vez que alguien informa de una nueva incidencia, esta incidencia debe ser evaluado. El triaje de una incidencia consiste en tomar el informe proporcionado por el informante e intentar reproducir el problema que describe.
Revisar un pull request¶
Una vez que se ha enviado una solicitud de extracción, es necesario revisarla antes de fusionarla. Independientemente de si estás profundamente familiarizado con el contenido, es probablemente una manera de poder ayudar con revisar una solicitud de extracción.
Sugiera una prestación nueva¶
¿Tienes alguna sugerencia o idea para añadir algo nuevo en alguna de las herramientas de BeeWare? Puede proponer una prestación nueva para su consideración.
Traducir contenido¶
BeeWare mantiene documentación en múltiples idiomas. Si conoces un idioma distinto del inglés, puedes ayudar traduciendo contenidos.
Utilizar las herramientas¶
¿Tienes una idea para una aplicación construida con Toga? ¿Tienes una aplicación existente que estaría empaquetada con Briefcase? Puedes utilizar las herramientas y comentar tu experiencia.
¿Cómo puedo contribuir?¶
Configurar un entorno de desarrollo¶
Antes de empezar a contribuir a BeeWare, necesitará configurar su entorno de desarrollo.
Reproducir una incidencia¶
Antes de solucionar una incidencia, tendrás que verificar que existe. Reproducir una incidencia también es una parte importante del triaje.
Trabaja desde una rama¶
Cuando se prepare para enviar una contribución, trabaje siempre a partir de una rama.
Evitar la ampliación del ámbito¶
Es importante mantener la concentración y evitar que se desborde el alcance de tu contribución.
Proponer una prestación nueva¶
Seguirás estos pasos para proponer una prestación nueva.
Escribir, ejecutar y probar código¶
Para actualizar o aportar código, tendrás que escribir, ejecutar y probar tu código.
Documentación de construcción¶
Para actualizar la documentación o contribuir a ella, tendrás que poder crear los documentos.
Escribir documentación¶
Para contribuir a la documentación, deberá escribir contenidos nuevos o actualizar los existentes.
Añadir una nota de cambio¶
Cada pull request debe ir acompañada de una nota de cambio.
Enviar una solicitud de extracción¶
Una vez que tus cambios estén listos, enviarás una solicitud de extracción para su revisión.
Proporcionar una revisión¶
Si se siente cómodo, puede hacer una crítica de la contribución de otra persona.
Traducir contenido¶
BeeWare utiliza Weblate para traducciones, lo que requiere unos pocos pasos para empezar.
Envía una incidencia nueva¶
Si te encuentras con un problema nuevo o un fallo, es útil enviar una incidencia.
¿Qué sucede después?¶
Revisión de solicitud de extracción¶
Cuando se envía una solicitud de extracción, el siguiente paso es la revisión del RP.
El proceso de lanzamiento¶
Las contribuciones fusionadas pasarán por el proceso de lanzamiento.
Guías de Estilo¶
Guía de estilo del código¶
Estas son las directrices para contribuir con código a los proyectos BeeWare.
Guía de estilo de la documentación¶
Éstas son las directrices para aportar documentación a los proyectos BeeWare.