Guía de Sprint

¡Bienvenidos a los sprints de BeeWare!

Te damos la bienvenida. Estamos encantados de que hayas decidido unirte a nosotros. Si aún no te has ya te has presentado a uno de los miembros del equipo Bee, hazlo. Una vez que una vez lo hayas hecho, vuelve aquí para empezar.

¿Qué es un sprint?

Un sprint es una oportunidad no estructurada para pasar unas horas o días trabajando en colaboración en un proyecto de código abierto. A menudo están vinculados a una conferencia; un sprint después de una conferencia ofrece la oportunidad de convertir la energía, el entusiasmo y el interés que ha generado una conferencia en mejoras del software que utilizamos a diario.

Los sprints también son una oportunidad para introducir a la gente en el proceso de contribuir al proyecto. Nuestra esperanza es que te diviertas tanto contribuyendo durante el sprint que te irás a casa y seguirás a seguir contribuyendo.

No importa cuánta experiencia tengas. En sprints anteriores, hemos fusionado contribuciones de personas con todos los niveles de experiencia: estudiantes de secundaria, recién graduados de bootcamps, personas que no se consideran programadores y desarrolladores experimentados. No importa cuál sea tu nivel de experiencia: podemos encontrar una forma de que contribuyas.

El código no es la única forma de contribuir. Un proyecto como BeeWare es mucho más que el código: necesitamos gente que escriba, que escriban, corrijan y traduzcan la documentación; necesitamos personas que mejoren el diseño de las páginas web. diseño de las páginas web; incluso el proceso de revisión de errores que se hace años y determinar que se han corregido por el camino es una valiosa contribución.

Las preguntas iniciales

Para empezar, vamos a hacerle algunas preguntas que nos permitan calibrar tus intereses y experiencia. Esto nos ayudará a encontrar la mejor contribuir. Repasa las preguntas, toma notas y luego busca a un miembro del miembro del Equipo Abeja y comparte tus respuestas. Si no entiendes Si no entiendes la pregunta, no te preocupes. Dinos lo que y trabajaremos juntos para resolverlo.

1. ¿Has utilizado BeeWare anteriormente?

Si no lo has hecho, empieza por seguir el Tutorial de BeeWare. Te dará una introducción sobre qué es el proyecto BeeWare y cómo encajan las piezas del proyecto. Si encuentras algún problema al seguir el tutorial, toma notas, porque asegurarte de que nadie más tenga el mismo problema es un gran tema para una primera contribución.

Una vez que hayas completado el tutorial hasta al menos el paso 4, pasa a la siguiente pregunta.

1. ¿Qué equipo informático tienes contigo?

El equipo que tienes contigo limita de forma práctica lo que puedes aportar. Por ejemplo, si tienes un portátil con Windows, no podrás trabajar en nada relacionado con iOS. ¿Tu portátil funciona con Windows, macOS, Linux u otro sistema operativo? ¿Tu teléfono es un dispositivo iOS o Android? ¿Tus dispositivos te los ha proporcionado tu empresa o son personales?

1. ¿Cuánta experiencia tienes escribiendo código Python?

¿Eres nuevo en programación? ¿Eres un veterano en Python? ¿Eres un veterano en programación que acaba de empezar a aprender Python? ¿Acabas de graduarte en un programa de formación intensiva? Queremos encontrar un problema que se adapte bien a tu nivel de experiencia.

1. ¿Estás familiarizado con los procesos de contribución de GitHub?

¿Utilizas GitHub (o un sitio similar para compartir código) para alojar tu propio código o contribuir a los proyectos de otros? ¿Sabes qué es la integración continua (CI)? ¿Has contribuido a algún proyecto que tenga ganchos pre-commit? Si te pidiera que «rebase tu PR contra main», ¿sabrías qué hacer?

1. ¿Has colaborado alguna vez en un proyecto de código abierto?

¿Has participado en un sprint anteriormente? ¿Alguna vez has enviado una solicitud de incorporación de cambios (PR, por sus siglas en inglés) a un proyecto de código abierto? ¿Sabes cómo utilizar GitHub para crear una solicitud de incorporación de cambios?

1. ¿Tienes alguna otra habilidad especial que pueda ser útil?

¿Estás familiarizado con una API GUI (como WinForms, Cocoa o GTK)? ¿Tienes un profundo conocimiento del funcionamiento interno de un sistema operativo en particular? ¿Eres experto en un lenguaje de programación distinto de Python? Si no tienes ninguna habilidad especial, no hay problema, pero si contamos con un gurú de Windows, queremos asegurarnos de que esas habilidades se aprovechen al máximo.

1. ¿Por qué te uniste a nosotros y qué te interesa?

«Parecía un proyecto interesante» es una respuesta perfectamente válida. Sin embargo, si hay más razones por las que te has unido a nosotros hoy, háznoslo saber. ¿Te interesa el desarrollo móvil o de escritorio? ¿El empaquetado? ¿Los sitios web? ¿Las aplicaciones de consola? Si no tienes un interés específico, ¿qué te parece más interesante de lo que has visto hasta ahora sobre BeeWare?

Ahora, busca a un miembro del Equipo Abeja para que comparta tus respuestas. Puede que te hagan algunas preguntas de seguimiento, pero entonces te indicarán un área un área en la que puedas contribuir.

Encuentre su problema

Si has hablado con algún miembro del equipo Bee, probablemente te haya indicado alguna parte del proyecto BeeWare en la que puedes contribuir; es posible que incluso te haya sugerido un tema específico en el que trabajar. Si no te ha dado un tema específico, probablemente te haya indicado los «Buenos primeros temas» para ese proyecto. ¿Qué significa eso?

GitHub ofrece una lista de problemas que permite a BeeWare (y a otros proyectos) para realizar un seguimiento de todos los problemas que se han reportado - que incluye errores explícitos, comportamiento inesperado que podría ser un error, las solicitudes de nuevas características, las solicitudes de más documentación - cualquier cosa que podría ser una manera de que BeeWare podría mejorarse. A medida que se nuevas cuestiones, el equipo de Bee marcará algunas de ellas como cuestiones para un colaborador novato: problemas que no exigen una solución una solución inmediata, pero están bien definidos o son fáciles de reproducir, y probablemente de la causa subyacente. Estos problemas se etiquetan como "buen para facilitar su búsqueda.

Para filtrar una lista de incidencias de GitHub por la etiqueta «good first issue», sigue estos pasos:

1. Haga clic en el botón «Etiquetas» situado encima de la lista de incidencias para activar el menú desplegable.
2. Escriba la palabra «bueno» en el cuadro de búsqueda situado en la parte superior del menú desplegable.
3. Haga clic en «buena primera edición» en la lista filtrada.

Filtrar las incidencias de GitHub por la etiqueta «good first issue» (buena primera incidencia).

Una vez que hayas encontrado un tema que te parezca interesante, lee los comentarios en el post, y publica un comentario en la discusión diciendo que que estás investigando el problema (por ejemplo, "Investigando esto en los sprints de PyCon US 2025"). BeeWare no "asigna" problemas explícitamente. contribuciones de cualquiera. Sin embargo, en una situación de sprint, necesitamos que no acabemos con dos personas trabajando en el mismo tema. dejar un comentario es una manera ligera de coordinar entre colaboradores.

Si sigues sin encontrar algo que te gustaría hacer, busca a un miembro del Bee Team y te ayudarán a concretar.

Configurar un entorno de desarrollo

Una vez que haya encontrado un problema, tendrá que configurar su entorno de desarrollo para que pueda trabajar en una solución. Cada proyecto BeeWare tiene su propia guía de contribución:

• Briefcase
• Toga
• Rubicon ObjC

Si el proyecto no está en esta lista, consulte el LÉEME del proyecto para obtener detalles sobre cómo configurarlo. Si cualquiera de las instrucciones no tienen sentido (o no puede encontrar esas instrucciones), busque un miembro del equipo de la abeja, y ellos te ayudarán. Y si crees que puedes mejorar las instrucciones para que otras personas no tengan el mismo problema. es una valiosa contribución.

Ya puede empezar a trabajar en su problema.

¿Qué sucede después de enviar mi solicitud de residencia permanente?

Una vez que haya enviado su pull request, y el pull request está pasando todos los controles automatizados, usted está listo para una revisión. Informe a uno de los miembros del que tiene un PR listo para revisión, y le echarán un vistazo. un vistazo.

Si se trata de su primer RP, es muy probable que la revisión encuentre algunos problemas. Puede ser un caso extremo que no haya considerado, o una convención de código que no haya seguido. que no has seguido. No te desanimes. Nadie - ni siquiera ni siquiera el equipo central - consigue PRs 100% correctos en el primer intento.

Una vez que la PR pase la revisión, tu revisor fusionará la PR, ¡y ya está! ¡Enhorabuena, has contribuido a BeeWare! Si esta es tu primera contribución a BeeWare, también te has ganado tu BeeWare Challenge Coin: busca a un miembro del equipo central y te dará una moneda.

¡Ayuda! ¡Estoy atascado!

Si te quedas atascado en algún punto del camino, busca a un miembro del Bee Team. No tengas miedo de hacer cualquier pregunta. Si estás atascado, queremos desatascarte. Si estás confuso, es porque el tema es complicado y no te lo hemos explicado. complicado y no lo hemos explicado lo suficientemente bien. Queremos y queremos asegurarnos de que tu sprint sea un éxito.

¿Qué pasa si no completo mi contribución durante el sprint?

¡No hay problema! Puedes enviar tu contribución en cualquier momento. Uno de los objetivos de los sprints es animarte y empoderarte para que sigas contribuyendo durante el resto del año. El equipo Bee está a tu disposición para ayudarte en cualquier parte de este proceso.

Si ya estabas trabajando en un problema de GitHub o enviaste una solicitud de incorporación de cambios, puedes seguir comunicándote a través de GitHub. Si tienes otras preguntas o necesitas ayuda en tiempo real, el mejor lugar para encontrarnos es el servidor Discord de BeeWare. ¡Esperamos seguir trabajando contigo!

Mejorar esta guía

Si tienes alguna sugerencia para mejorar esta guía de sprints, háznosla llegar. ¿Qué te ha funcionado? ¿Qué no ha funcionado? ¿Qué podemos mejorar? Y recuerda: solucionar un ¡problema con esta Guía Sprint cuenta como una contribución a BeeWare!