La meilleure façon de commencer une contribution à un logiciel libre est d'en faire une qui corresponde à vos connaissances, à votre expérience et à votre domaine d'intérêt. quelque chose qui correspond à vos connaissances, à votre expérience et à votre domaine d'intérêt.
Avant de commencer
Avant de commencer à contribuer, il peut être utile de se faire une idée du projet dans son ensemble. dans son ensemble. Si vous n'avez pas encore fait le [BeeWare Tutorial] (https://docs.beeware.org), commencez par là. Cela vous donnera les outils les plus importants de BeeWare, afin que vous puissiez voir comment ils s'articulent. comment ils s'intègrent les uns aux autres.
Une fois que vous aurez terminé ce tutoriel, vous serez prêt à choisir quelque chose sur lequel travailler. à travailler. Si vous avez eu des difficultés à faire le tutoriel - si vous avez rencontré un bogue, ou si le langage utilisé pour décrire une étape n'était pas clair - c'est un problème. bogue, ou si le langage utilisé pour décrire une étape n'était pas clair - c'est un bon point de départ ! c'est un bon point de départ ! Si vous pouvez transformer votre expérience en une amélioration du tutoriel, la prochaine personne qui suivra le tutoriel ne rencontrera pas le même problème. ne rencontrera pas le même problème.
Cependant, si votre expérience du tutorat s'est déroulée sans encombre (et nous espérons qu'elle l'a été !), voici quelques idées pour vous impliquer, en fonction de vos besoins. que ce fut le cas !), voici quelques idées pour vous impliquer, selon vos compétences et vos intérêts. de vos compétences et de vos intérêts.
Programmation Python
Porte-documents
Si vous souhaitez contribuer à un outil dont l'énoncé du problème est clairement défini, mais qui a besoin d'être débarrassé de ses bogues et d'être complété par de nouvelles fonctionnalités
clairement défini, mais qui a besoin de corriger des bogues et d'ajouter des fonctionnalités,
[Briefcase] (https://github.com/beeware/briefcase) est peut-être le projet qu'il vous faut.
pour vous. Briefcase est un outil permettant d'empaqueter un projet Python en tant qu'application GUI
une application GUI autonome. Il prend un fichier de configuration pyproject.toml
, et
et utilise ces données de configuration pour générer des installateurs ou des
distribuables.
La mallette [issue tracker] (https://github.com/beeware/briefcase/issues) contient une collection de suggestions de fonctionnalités (et un plus petit nombre de bogues). de suggestions de fonctionnalités (et un plus petit nombre de bogues). Si c'est votre première fois, cherchez l'un des tickets étiquetés good premier issue - Il s'agit de questions qui ont été spécifiquement choisies pour les premiers premiers contributeurs parce qu'ils devraient être relativement simples à relativement simples à mettre en œuvre. Vous pouvez également trouver utile de filtrer les tickets en fonction de la plateforme que vous utilisez pour le développement. la plateforme que vous utilisez pour le développement - il sera difficile de corriger un Il sera difficile de corriger un bogue Linux si vous n'avez pas de machine Linux à utiliser pour les tests !
Si vous souhaitez contribuer à un projet spécifique, vous pouvez également filtrer les bonnes premières questions par projet spécifique en utilisant ces liens :
- Mallette
- Toga](https://github.com/search?q=repo%3Abeeware%2Ftoga+label%3A%22good+first+issue%22+is%3Aissue+is%3Aopen&type=issues)
- The BeeWare tutorial
- Le site web de BeeWare (https://github.com/search?q=repo%3Abeeware%2Fbeeware.github.io+label%3A%22good+first+issue%22+is%3Aissue+is%3Aopen&type=issues)
Choisissez un ticket, laissez un commentaire indiquant que vous étudiez le problème, et et essayez de développer une demande d'extension pour corriger le problème !
Programmation de l'interface graphique
Si vous avez de l'expérience avec une bibliothèque de widgets natifs - Cocoa sur macOS, GTK+ sous Linux, Windows Forms, ou les bibliothèques natives iOS ou Android, vous pouvez peut-être nous aider avec [Toga] (https://github.com/beeware/toga). Toga est une boîte à outils de widgets multiplateforme - elle fournit une interface commune pour les éléments d'interface utilisateur tels que les boutons et les arbres. pour les éléments d'interface utilisateur tels que les boutons et les arbres.
Toga dispose d'une série d'interfaces déjà définies ; cependant, l'implémentation de ces interfaces n'est pas complète sur toutes les plateformes. l'implémentation de ces interfaces n'est pas complète sur toutes les plateformes. Choisissez un widget et implémentez-le pour la plateforme de votre choix !
Même si vous ne connaissez pas de bibliothèque de widgets natifs, vous pourrez peut-être nous aider avec Toga. d'aider avec Toga. L'écriture de nouveaux widgets est beaucoup moins compliquée qu'il n'y paraît. qu'il n'y paraît. Chaque plateforme dispose d'une documentation sur la manière d'utiliser ses API natives. natives, et le processus de traduction de la documentation de la plateforme à partir d'une autre langue (par ex. d'un autre langage (par exemple, Objective C ou C#) est un processus relativement simple. relativement simple. Le code existant devrait vous donner quelques indications et l'équipe de BeeWare est prête à vous aider si vous en avez besoin. si vous en avez besoin. Sautez sur le BeeWare Discord et nous ferons tout ce qui est en notre pouvoir pour vous aider ! et nous ferons tout ce qui est en notre pouvoir pour vous aider !
Si vous n'êtes pas prêt à transformer le code d'un langage à un autre - il y a toujours la suite de tests. La bibliothèque de base de Toga a également une suite de tests, mais la couverture de cette suite de tests n'est pas très bonne. mais la couverture de cette suite de tests n'est pas très bonne. Choisissez une interface et voyez si vous pouvez écrire un test pour elle !
Documentation
Une bonne documentation est essentielle à la réussite de tout projet. Nous savons que Toga et Briefcase ont tous deux besoin d'une documentation importante. (https://github.com/beeware/briefcase) ont tous deux besoin d'améliorer considérablement leur améliorer leur documentation. Vous avez suivi le didacticiel ; jetez maintenant un coup d'œil à la documentation de Toga. jeter un coup d'œil à la documentation de Toga et de Briefcase et voir si vous pouvez améliorer leur documentation. Briefcase et voyez si vous pouvez trouver un moyen d'améliorer les tutoriels, les références et la documentation. d'améliorer les didacticiels, les références et les guides thématiques qui s'y trouvent. qui s'y trouvent.
Tutoriels
L'une des meilleures façons de contribuer est de s'assurer que notre documentation d'introduction et de d'introduction et de tutoriel soit solide comme le roc. Choisissez un projet qui vous intéresse dans la suite BeeWare, et essayez de suivre le guide de démarrage et le tutoriel. de la suite BeeWare, et essayez de suivre le guide de démarrage et le tutoriel. tutoriel. Si vous ne trouvez pas le guide de démarrage, c'est la première chose à signaler ! la première chose à signaler !
Au fur et à mesure que vous avancez dans le tutoriel, notez tout ce qui n'a pas de sens ou qui ne fonctionne pas. qui n'a pas de sens ou qui ne fonctionne pas. Ouvrez ensuite un rapport de bogue pour ces problèmes.
Windows
Si vous êtes un utilisateur de Windows, BeeWare peut définitivement avoir besoin de votre aide. L'équipe de base de utilisent tous Linux et macOS dans leur développement quotidien, et de ce fait, il est et par conséquent, il est très facile pour les incompatibilités Windows de se glisser. Cela est presque toujours dû à un oubli. est presque toujours due à un oubli. Identifier - et peut-être même problèmes liés à l'utilisation des outils BeeWare sous Windows est d'une grande d'aide.
Langues
Parlez-vous une autre langue que l'anglais ? Actuellement, l'équipe principale sont tous de langue maternelle anglaise. Fournir des traductions de documentation, ou de nouveaux tutoriels ou guides dans votre langue maternelle est une excellente façon de contribuer. Choisissez un projet qui dispose déjà d'une documentation et traduisez ce texte. Vous pouvez également partir de zéro et rédigez un tout nouveau tutoriel.
Si vous parlez une langue dont le jeu de caractères n'est pas latin (par ex. le russe ou le chinois), ou une langue dont l'écriture va de droite à gauche (par exemple, l'hébreu ou l'arabe), vous pourrez nous indiquer tous les endroits où nous avons supposé que le jeu de caractères n'était pas le bon. l'hébreu ou l'arabe), vous pourrez nous indiquer tous les endroits où nous avons supposé un codage ASCII simple ou des conventions de gauche à droite. Choisissez l'un des projets projets BeeWare en cours et essayez de l'utiliser dans votre langue maternelle. langue maternelle. Si vous rencontrez des problèmes, signalez-les en tant que bogues. si vous vous sentez particulièrement aventureux, essayez de trouver comment *Si vous vous sentez particulièrement aventureux, essayez de trouver un moyen de corriger le bogue.
Utilisation pratique
L'une des meilleures façons pour nous de déterminer où se situent nos lacunes - à la fois dans la documentation et dans les API - est que les gens utilisent réellement BeeWare pour construire des applications. documentation et les API - est que les gens utilisent BeeWare pour construire quelque chose. quelque chose. Donc, si aucune des idées proposées jusqu'à présent ne vous semble intéressante, pourquoi ne pas essayer quelque chose de votre cru ? Utilisez la suite BeeWare pour créer l'application que vous avez toujours voulue - une visualisation de bureau d'une source de données, ou une application mobile pour suivre vos activités - peu importe ce que vous voulez. une application mobile pour suivre vos activités - quelle qu'elle soit, essayez de la construire. essayez de la créer.
Nous pouvons presque garantir que vous rencontrerez des problèmes. BeeWare est un projet encore très jeune projet. Mais les problèmes que vous rencontrerez nous donneront une bonne indication de ce qu'il faut faire. Ils nous indiqueront quels sont les widgets dont nous avons besoin et quelle est la documentation qui doit être mise à jour. et quelle documentation doit être améliorée. Ainsi, lorsque vous rencontrerez problèmes en construisant votre propre application, enregistrez les problèmes avec les projets BeeWare qui ont causé des problèmes. Cela nous permettra d'identifier ce que nous devons améliorer - et cela pourrait même être une source d'inspiration pour vous de contribuer !