Guía de contribución¶
Hay muchas formas de contribuir a BeeWare. 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 nueva función¶
¿Te falta BeeWare alguna función que te gustaría ver? Puedes implementar una nueva función.
Escribir documentación¶
Ninguna funcionalidad 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 nueva función¶
¿Tienes alguna sugerencia o idea para añadir algo nuevo a alguna de las herramientas de BeeWare? Puede proponer una nueva función para su consideración.
Traducir contenido¶
BeeWare mantiene documentación en varios idiomas. Si conoce un idioma distinto del inglés, puede ayudar traduciendo contenidos.
Usa las herramientas¶
¿Tienes una idea para una aplicación construida con Toga? ¿Tienes una aplicación existente que podría empaquetarse 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, tendrá que 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 de aplicación¶
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 nueva función.
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 nuevos contenidos o actualizar los existentes.
Añadir una nota de cambio¶
Cada pull request debe ir acompañada de una nota de cambio.
Submit a pull request¶
Una vez que tus cambios estén listos, enviarás un pull request para su revisión.
Proporcione una reseña¶
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.
¿Y ahora qué?¶
Pull request review¶
Cuando se envía un pull request, el siguiente paso es la revisión del PR.
El proceso de liberación¶
Las contribuciones fusionadas pasarán por el proceso de publicación.
Guías de estilo¶
Código de estilo de la guía¶
Estas son las directrices para contribuir con código a los proyectos BeeWare.
Libro de estilo de la documentación¶
Éstas son las directrices para aportar documentación a los proyectos BeeWare.