¡Bienvenido 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 tienes. En sprints anteriores, hemos fusionado las contribuciones de las personas en todos los niveles de experiencia - estudiantes de secundaria, recién graduados de bootcamps, gente que no se considera programadores y desarrolladores experimentados. No importa tu podemos encontrar la manera 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. ¿Ha utilizado BeeWare antes?

    Si aún no lo ha hecho, empiece con el BeeWare Tutorial. Le dará una introducción a lo que es el proyecto BeeWare, y cómo las piezas de del proyecto encajan entre sí. Si tienes algún problema tutorial, tome notas - porque asegurarse de que nadie más tiene el mismo ¡problema es un gran tema para una primera contribución!

    Una vez que haya terminado el tutorial hasta al menos el paso 4, pase a la la siguiente pregunta.

  2. ¿Qué equipo informático lleva consigo?

    El equipo que llevas contigo pone límites prácticos a lo que puede contribuir. Por ejemplo, si tienes un portátil con Windows, no vas a poder trabajar en nada relacionado con iOS. no podrás trabajar en nada que tenga que ver con iOS. ¿Tu ¿Funciona tu portátil con Windows, macOS, Linux u otro sistema operativo? ¿Es tu teléfono un dispositivo iOS o Android? ¿Sus dispositivos han sido proporcionados por su por su empresa, o son sus propios dispositivos personales?

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

    ¿Eres nuevo en programación? ¿Un veterano de Python? ¿Un veterano de la programación que acaba de empezar a aprender Python? ¿Recién graduado de un programa bootcamp? Queremos encontrar un problema que se adapte a tu nivel de experiencia. tu nivel de experiencia.

  4. ¿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 proyectos de otros? propio código o para contribuir a los proyectos de otros? ¿Sabes lo que es la (integración continua)? ¿Has contribuido a un proyecto que tiene ganchos de precompromiso? Si te pidiera "rebase your PR against main", ¿sabrías qué hacer?

  5. ¿Ha contribuido antes a un proyecto de código abierto?

    ¿Ha asistido a algún sprint en el pasado? ¿Has enviado alguna vez un PR (pull request) a un proyecto de código abierto? ¿Estás familiarizado con utilizar Github para crear un pull request?

  6. ¿Tiene alguna otra habilidad especial que pueda ser útil?

    ¿Está familiarizado con una API de interfaz gráfica de usuario (como Winforms, Cocoa o GTK)? ¿Conoce a fondo el funcionamiento interno de un determinado sistema operativo? ¿Es usted un experto en un lenguaje de programación que no sea Python? Si no tiene conocimientos especiales, no hay problema. problema, pero si tenemos a un gurú de Windows entre manos, queremos queremos asegurarnos de que esas habilidades se utilizan bien.

  7. **¿Por qué se ha unido a nosotros y qué le interesa?

    "Parecías un proyecto amistoso" es una respuesta perfectamente válida. Sin embargo, si hay algo más por lo que se ha unido a nosotros hoy, háganoslo saber. ¿Te interesa el desarrollo móvil o de escritorio? ¿Empaquetado? ¿Sitios web? ¿Aplicaciones de consola? Si usted no tiene un interés específico - lo que más interesante basándose en lo que ha visto hasta ahora sobre BeeWare? 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.

Encuentra tu problema

Si ha hablado con un miembro del equipo Bee, probablemente le habrá indicado una parte del proyecto BeeWare en la que puede contribuir. una parte del proyecto BeeWare en la que puede contribuir. incluso te habrán sugerido un tema específico en el que trabajar. Si no le han Si no te han sugerido un tema concreto, probablemente te hayan indicado los "Buenos 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 "primera incidencia buena", siga estos pasos:

  1. Haga clic en el botón "Etiquetas" situado encima de la lista de temas para activar el menú desplegable.
    1. Escriba la palabra "bueno" en el cuadro de búsqueda situado en la parte superior del menú desplegable. desplegable.
    1. Haga clic en "buen primer número" en la lista filtrada.

./github-good-first-issue-filter.png

Filtrando los temas de GitHub por la etiqueta "good first issue"
</figure>

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:

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é ocurre después de enviar mi RP?

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 el RP pase la revisión, su revisor fusionará el RP - y ya está ¡listo! Enhorabuena: ¡ha contribuido a BeeWare! Si ésta es su primera contribución a BeeWare, también habrás ganado tu BeeWare Challenge Coin - busca a un miembro del equipo central, ¡y te darán 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.