¿Qué debo hacer?

El mejor lugar para empezar con cualquier contribución al código abierto es con algo que se ajuste a tus conocimientos, experiencia y área de interés.

Antes de empezar

Antes de empezar a contribuir, puede ser útil hacerse una idea del proyecto en su conjunto. Si aún no ha realizado el BeeWare Tutorial, empieza por ahí. Esto le dará a las herramientas más importantes de BeeWare, para que pueda ver cómo encajan entre sí.

Una vez que hayas completado ese tutorial, estarás listo para elegir algo para trabajar. Si has tenido algún problema haciendo el tutorial - si te has topado con un error, o si el lenguaje utilizado para describir un paso no era claro - que es un un buen punto de partida. Si puedes convertir tu experiencia en en una mejora del tutorial, la siguiente persona que haga el tutorial no con el mismo problema.

Sin embargo, si su experiencia con el tutorial ha sido completamente fluida (¡y esperamos que lo haya sido!), aquí tiene algunas ideas sobre cómo participar, en función de sus necesidades. que lo haya sido), aquí tienes algunas ideas para participar en función de tus tus habilidades e intereses.

Programación Python

Maletín

Si desea contribuir a una herramienta que tiene un planteamiento del problema claramente definido, pero necesita que se eliminen errores y se añadan funciones, puede hacerlo. claramente definido, pero necesita que se eliminen errores y se añadan funciones, Maletín puede ser el proyecto para ti. para usted. Briefcase es una herramienta para empaquetar un proyecto Python como una aplicación GUI independiente. independiente. Toma un archivo de configuración pyproject.toml, y utiliza los datos de configuración para generar instaladores o distribuibles distribuibles.

El Maletín issue tracker tiene una colección de sugerencias de funciones (y un número menor de errores). Si es la primera vez primera vez, busque uno de los tickets etiquetados como buena primer issue. Se trata de temas elegidos específicamente para quienes contribuyentes por primera vez porque deberían ser relativamente sencillas de implementar. También puede resultarle útil filtrar los tickets por la plataforma que utiliza para el desarrollo. plataforma que utiliza realmente para el desarrollo - será difícil corregir será difícil arreglar un error de Linux si no tienes una máquina Linux para probarlo.

Si desea contribuir a un proyecto específico, también puede filtrar las buenas primeras ediciones por proyectos específicos utilizando estos enlaces:

Elige un ticket, deja un comentario diciendo que estás investigando el problema, y intenta desarrollar un pull request con una solución.

Programación GUI

Si tienes experiencia con una biblioteca nativa de widgets - Cocoa en macOS, GTK+ en Linux, Windows Forms, o las librerías nativas de iOS o Android, tal vez puedas ayudar con Toga. Toga es un conjunto de herramientas de widgets multiplataforma que proporciona una interfaz común para elementos de interfaz de usuario como botones y árboles.

Toga tiene una serie de interfaces ya definidas; sin embargo, la implementación de esas interfaces no está completa en todas las plataformas. Elige un widget e impleméntalo para la plataforma que prefieras.

Aunque no conozcas una librería nativa de widgets, es posible que puedas ayudar con Toga. Escribir nuevos widgets es mucho menos complicado de lo que parece. de lo que parece. Cada plataforma tiene documentación sobre cómo usar sus API nativas. API nativas, y el proceso de traducir la documentación de la plataforma desde otro lenguaje (por ejemplo, Objective C o C#) es un proceso relativamente relativamente sencillo. El código existente debería darle algunas indicaciones de cómo se puede hacer esto, y el equipo BeeWare está feliz de ayudar si usted necesita. Entra en BeeWare Discord y haremos todo lo que podamos para ayudarte. para ayudarte.

Even if you're not up for transforming code from one language to another, Toga's core library — as well as Travertino, a subpackage covering styling and layout — are pure Python, and platform-agnostic. Take a look at issues not tagged with a specific platform — many of them can probably be fixed with little or no change to any platform-specific code.

Documentación

Una buena documentación es esencial para el éxito de cualquier proyecto. Sabemos que Toga y Maletín necesitan importantes mejoras significativas en su documentación. Ya has hecho el tutorial; ahora echa ahora eche un vistazo a la documentación de Toga y Maletín y vea si puede encontrar una forma de mejorar los tutoriales, las referencias y la documentación. forma de mejorar los tutoriales, referencias y guías temáticas que hay en ellos. allí.

Tutoriales

Una de las mejores formas de contribuir es asegurarnos de que nuestra documentación introductoria y sea sólida como una roca. Elija un proyecto de interés de BeeWare e intenta seguir la guía de introducción y el tutorial. tutorial. Si no puede encontrar la guía de iniciación - ¡eso es ¡lo primero que debe informar!

A medida que avance en el tutorial, tome nota de todo lo que no tenga sentido o no funcione. que no tenga sentido o no funcione. A continuación, abra un informe de errores para esos problemas.

Windows

Si eres usuario de Windows, BeeWare puede definitivamente utilizar tu ayuda. El equipo central de equipo central utiliza Linux y macOS en su desarrollo diario, y como incompatibilidades con Windows. Este casi siempre se debe a un descuido. Identificar - y tal vez incluso con la ejecución de herramientas BeeWare en Windows es una ayuda inmensa. ayuda.

Idiomas

¿Habla otro idioma que no sea el inglés? En la actualidad, el equipo son todos hablantes nativos de inglés. Si desea traducir documentación, o tutoriales o guías completamente nuevos en su lengua es una buena forma de contribuir. Elija un proyecto que ya tenga documentación y traduzca ese texto. También puedes empezar desde cero y escribe un tutorial completamente nuevo.

Si hablas un idioma con un juego de caracteres no latino (por ejemplo, ruso o chino), o una lengua con escritura de derecha a izquierda (por ejemplo, hebreo o hebreo o árabe) podrá indicarnos todos los lugares en los que hemos asumido codificación ASCII simple o convenciones de izquierda a derecha. Elija cualquiera de los proyectos BeeWare activos e intente utilizarlo en su lengua materna. nativo. Si encuentra algún problema, notifíquelo como error. si te sientes particularmente aventurero, mira a ver si puedes solucionar el error también. arreglar el fallo.

Uso práctico

Una de las mejores maneras de determinar dónde están nuestras lagunas, tanto en la documentación como en las API, es que la gente utilice BeeWare para crear aplicaciones. tanto en la documentación como en las API, es que la gente use BeeWare para construir algo. algo. Así que, si ninguna de las ideas hasta ahora suena interesante, ¿por qué no ¿Intentar algo propio? Utiliza la suite BeeWare para crear esa aplicación una visualización de escritorio de una fuente de datos, o una aplicación móvil para hacer un seguimiento de tus actividades. o una aplicación móvil para hacer un seguimiento de tus actividades. construirla.

Casi podemos garantizarle que encontrará problemas. BeeWare es un proyecto proyecto muy joven. Pero los problemas que encuentre nos dará una gran indicación de lo que hay que abordar. Nos indicará qué widgets necesitamos, y qué documentación necesita ser mejorada. Por lo tanto, como usted golpea problemas construyendo su propia aplicación, registre los problemas con los proyectos BeeWare que causaron problemas. Esto nos permitirá identificar lo que tenemos que mejorar - y, podría incluso ser una fuente de inspiración para que usted pueda ¡contribuir!