Bienvenue aux Sprints BeeWare !
Bienvenue ! Nous sommes ravis que vous ayez décidé de nous rejoindre ! Si vous ne vous êtes pas vous êtes déjà présenté à l'un des membres de l'équipe de l'abeille, faites-le. Une fois que vous l'aurez fait, revenez ici pour commencer. une fois que vous l'aurez fait, revenez ici pour commencer.
Qu'est-ce qu'un sprint ?
Un sprint est une opportunité non structurée de passer quelques heures ou quelques jours quelques heures ou quelques jours à travailler en collaboration sur un projet Open Source. Ils sont souvent liés à une conférence ; un sprint après une conférence fournit une opportunité de transformer l'énergie, l'enthousiasme et l'intérêt qu'une conférence a générés en améliorant les logiciels que nous utilisons quotidiennement.
Les sprints sont également l'occasion d'initier les gens au processus de contribuer au projet. Nous espérons que vous prendrez tellement de plaisir à pendant le sprint que vous rentrerez chez vous et continuerez à contribuer !
[L'expérience n'a pas d'importance] (/contributing/first-time/imposter-syndrome/). (/contribution/première fois/syndrome de l'imposteur/). Lors des sprints précédents, nous avons fusionné les contributions de personnes de tous niveaux d'expérience, nous avons fusionné des contributions de personnes de tous niveaux d'expérience - des des lycéens, des diplômés de bootcamp, des personnes qui ne se considèrent pas des personnes qui ne se considèrent pas comme des programmeurs, et des développeurs chevronnés. Quel que soit votre niveau d'expérience - nous pouvons trouver un moyen pour vous de contribuer.
Le code n'est pas le seul moyen de contribuer. Un projet comme BeeWare est bien plus qu'un simple code - nous avons besoin de personnes pour écrire, relire et traduire la documentation ; nous avons besoin de personnes pour améliorer le système, pour rédiger, relire et traduire la documentation ; nous avons besoin de personnes pour améliorer la conception des pages web ; même le processus d'élimination des bogues qui ont été améliorer la conception des pages web ; même le processus d'examen des bogues qui ont été bogues signalés il y a des années et de déterminer s'ils ont été corrigés en cours de route. est une contribution précieuse.
Les premières questions
Pour commencer, nous allons vous poser quelques questions afin d'évaluer vos intérêts et votre expérience. vos intérêts et votre expérience. Cela nous aidera à trouver le meilleur moyen de contribuer. Répondez aux questions, prenez des notes, puis trouvez un membre de l'équipe de l'abeille et partagez vos réponses. un membre de l'équipe Abeille et partagez vos réponses. Si vous ne comprenez pas la question posée, ne vous inquiétez pas ! Faites-nous savoir ce que vous et nous travaillerons ensemble pour trouver la réponse.
**Avez-vous déjà utilisé BeeWare ?
Si vous ne l'avez pas encore fait, commencez par lire le [BeeWare (https://docs.beeware.org/en/latest/). Il vous donnera une une introduction à ce qu'est le projet BeeWare et à la façon dont les éléments du projet s'assemblent. du projet s'imbriquent les unes dans les autres. Si vous rencontrez des difficultés lors de l'exécution du tutorial, prenez des notes - parce que s'assurer que personne d'autre n'a le même problème est un excellent sujet pour une première contribution !
Une fois que vous avez terminé le tutoriel au moins jusqu'à l'étape 4, passez à la question suivante. à la question suivante.
**Quels sont les équipements informatiques dont vous disposez ?
L'équipement que vous avez avec vous impose des limites pratiques à ce que vous pouvez faire. pouvez contribuer. Par exemple, si vous avez un ordinateur portable Windows, vous ne pourrez pas travailler sur des projets liés à iOS. vous ne serez pas en mesure de travailler sur quoi que ce soit en rapport avec iOS. Votre ordinateur portable fonctionne-t-il sous Windows, macOS, Linux ou autre chose ? Votre téléphone est-il un appareil iOS ou Android ? Vos appareils ont-ils été fournis par votre employeur, ou s'agit-il de vos appareils personnels ?
**Combien d'expérience avez-vous dans l'écriture de code Python ?
Vous êtes novice en programmation ? Un vétéran de Python ? Un vétéran du codage qui qui vient juste de commencer à apprendre Python ? Fraîchement diplômé d'un programme d'entraînement ? Nous voulons trouver un problème qui corresponde à votre niveau d'expérience. à votre niveau d'expérience.
**Êtes-vous familier avec les processus de contribution de Github ?
Utilisez-vous GitHub (ou un site de partage de code similaire) pour héberger votre propre code ou contribuer à d'autres projets ? pour héberger votre propre code ou contribuer aux projets d'autres personnes ? Savez-vous ce qu'est l'intégration continue ? (intégration continue) ? Avez-vous contribué à un projet qui a des crochets de pré-commission ? Si je vous demandais de "rebaser votre PR sur main", sauriez-vous quoi faire ?
**Avez-vous déjà contribué à un projet Open Source ?
Avez-vous déjà participé à un sprint ? Avez-vous déjà soumis une PR (pull request) à un projet Open Source ? Savez-vous comment comment utiliser Github pour créer une pull request ?
**Avez-vous d'autres compétences particulières qui pourraient être utiles ?
Êtes-vous familier avec une API d'interface graphique (telle que Winforms, Cocoa ou GTK) ? Avez-vous une connaissance approfondie des éléments internes d'un système d'exploitation particulier ? système d'exploitation ? Êtes-vous un expert dans un langage de programmation autre que que Python ? Si vous n'avez pas de compétences particulières, ce n'est pas un problème. mais si nous avons un gourou de Windows, nous voulons nous assurer que ces compétences sont mises à profit. nous voulons nous assurer que ces compétences sont utilisées à bon escient.
**Pourquoi nous avoir rejoints et quels sont vos centres d'intérêt ?
La réponse "Vous avez l'air d'un projet sympathique" est une réponse tout à fait acceptable. Toutefois, si vous avez d'autres raisons de nous rejoindre aujourd'hui, faites-le nous savoir. Êtes-vous intéressé par le développement mobile ou bureautique ? L'emballage ? Les sites web ? Les applications de console ? Si vous n'avez pas d'intérêt spécifique - qu'est-ce qui vous semble le plus intéressant d'après ce que vous avez vu de Bee ? semble le plus intéressant d'après ce que vous avez vu de BeeWare jusqu'ici jusqu'à présent ?
Maintenant, trouvez un membre de l'équipe de l'abeille pour partager vos réponses. Il se peut qu'il pose des questions complémentaires, mais il vous indiquera ensuite un domaine dans lequel vous pourrez apporter votre contribution. d'un domaine dans lequel vous devriez pouvoir apporter votre contribution.
Trouvez votre problème
Si vous avez parlé à un membre de l'équipe Bee, il vous a probablement indiqué une partie du projet BeeWare où vous pouvez contribuer. vous a probablement indiqué une partie du projet BeeWare où vous pouvez contribuer. vous a peut-être même suggéré un problème spécifique sur lequel travailler. S'il ne vous a pas vous a pas donné de problème spécifique, il vous a probablement indiqué les "Bons premières questions" pour ce projet. Qu'est-ce que cela signifie ?
GitHub fournit une liste de problèmes qui permet à BeeWare (et à d'autres projets) de garder une trace de tous les problèmes qui ont été signalés. projets) de garder une trace de tous les problèmes qui ont été signalés - ce qui inclut les bogues explicites, les comportements inattendus qui cela inclut les bugs explicites, les comportements inattendus qui pourraient être des bugs, les demandes de nouvelles fonctionnalités, les demandes de documentation - tout ce qui peut être un moyen pour BeeWare d'améliorer sa performance. tout ce qui pourrait permettre d'améliorer BeeWare. Au fur et à mesure que de nouveaux problèmes sont l'équipe Bee signalera certains d'entre eux comme étant des problèmes qui conviennent à un premier contributeur - des problèmes qui n'exigent pas une une correction immédiate, mais qui sont bien définis ou faciles à reproduire, et qui ont probablement une bonne piste sur la cause sous-jacente. Ces problèmes sont étiquetés "bon premier problème" pour les rendre plus faciles à trouver.
Pour filtrer une liste de problèmes GitHub en fonction de l'étiquette "bon premier problème", suivez les étapes suivantes les étapes suivantes :
- Cliquez sur le bouton "Etiquettes" au-dessus de la liste des questions pour activer le menu déroulant. le menu déroulant.
- Tapez le mot "bon" dans le champ de recherche situé en haut du menu déroulant. dans le champ de recherche situé en haut du menu déroulant.
- Cliquez sur "bon premier numéro" dans la liste filtrée.
Une fois que vous avez trouvé un sujet qui vous semble intéressant, lisez tous les commentaires sur l'article et publiez un commentaire dans la discussion en indiquant que le sujet est intéressant. commentaires sur l'article, et postez un commentaire dans la discussion en disant que vous que vous étudiez le problème (par exemple, "Looking into this at the PyCon US 2025"). BeeWare n'attribue pas explicitement les problèmes - nous acceptons les contributions de n'importe qui. contributions de n'importe qui. Cependant, dans le cadre d'un sprint, nous devons sprint, nous devons nous assurer que nous ne nous retrouvons pas avec deux personnes travaillant sur le même problème. laisser un commentaire est un moyen léger de coordination entre les contributeurs. contributeurs.
Si vous ne trouvez toujours pas ce que vous aimeriez faire, contactez un membre de l'équipe Bee Team et il vous aidera à cibler un problème spécifique.
Mettre en place un environnement de développement
Une fois le problème détecté, vous devez mettre en place votre environnement de développement afin de pouvoir travailler à la résolution du problème. afin de pouvoir travailler sur un correctif. Chaque projet BeeWare a son propre guide de contribution :
- Porte-documents](https://briefcase.readthedocs.io/en/latest/how-to/contribute/index.html)
- Toga](https://toga.readthedocs.io/en/latest/how-to/contribute/index.html)
- Rubicon ObjC
Si le projet ne figure pas dans cette liste, consultez le fichier README du projet pour savoir comment le configurer. sur la façon de s'installer. Si l'une des instructions n'a pas de sens (ou si vous ne les trouvez pas), contactez un membre de l'équipe Bee. vous ne trouvez pas ces instructions), contactez un membre de l'équipe Bee, et et ils vous aideront à sortir de l'impasse. Et si vous pensez pouvoir améliorer les instructions afin que d'autres personnes ne rencontrent pas le même problème, l'amélioration du guide de contribution est une contribution précieuse ! est une contribution précieuse !
Vous pouvez maintenant commencer à travailler sur votre problème !
Que se passe-t-il une fois que j'ai soumis ma demande de subvention ?
Une fois que vous avez soumis votre demande d'extraction et qu'elle a passé toutes les vérifications automatiques, vous êtes prêt pour une révision. toutes les vérifications automatiques, vous êtes prêt pour une révision. Faites savoir à l'un des membres de l'équipe que vous avez un PR prêt à être revu, et il y jettera un coup d'oeil. jeter un coup d'œil.
S'il s'agit de votre première RP, il est fort probable que l'examen révèle certains problèmes. problèmes. Il peut s'agir d'un cas particulier que vous n'avez pas pris en compte, ou d'une convention de code que vous n'avez pas respectée. que vous n'avez pas respectée. Ne vous découragez pas ! Personne - pas même même pas l'équipe de base - n'obtient des PRs 100% corrects du premier coup.
Une fois que le PR a passé l'examen, votre réviseur fusionne le PR - et c'est terminé. terminé ! Félicitations - vous avez contribué à BeeWare ! S'il s'agit de votre première contribution à BeeWare, vous avez également gagné votre pièce de défi BeeWare Challenge Coin - trouvez un membre de l'équipe de base, et il vous donnera une pièce. et il vous donnera une pièce !
Aidez-nous ! Je suis coincé !
Si vous êtes bloqué à un moment ou à un autre de votre parcours, adressez-vous à un membre de l'équipe Bee de l'équipe de l'abeille. N'ayez pas peur de poser n'importe quelle question. Si vous êtes bloqué, nous voulons vous aider à sortir de l'impasse. Si vous êtes confus, c'est que le sujet est compliqué et que nous ne l'avons pas expliqué. compliqué et que nous ne l'avons pas assez bien expliqué. Nous sommes impatients de vous aider. d'aider - et nous voulons nous assurer que votre sprint sera couronné de succès.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!