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 un problema

La contribución más obvia que puedes hacer es escribir código para solucionar un problema conocido.

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 an issue

Cada vez que alguien informa de un nuevo problema, éste debe ser evaluado. El triaje de una incidencia consiste en tomar la información proporcionada por el informador e intentar reproducir el problema que describe.

Revisar un pull request

Una vez que se ha enviado una pull request, es necesario revisarla antes de fusionarla. Independientemente de si usted está profundamente familiarizado con el contenido, es probable que haya una manera de que usted puede 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 un problema

Antes de solucionar un problema, tendrás que verificar que existe. Reproducir un problema 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 nueva característica

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.

Presentar una nueva edición

Si te encuentras con un nuevo problema o 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.