Guide Sprint

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 !

Peu importe votre niveau d'expérience. Lors des sprints précédents, nous avons fusionné les contributions de personnes de tous niveaux d'expérience : lycéens, jeunes diplômés de bootcamps, personnes qui ne se considèrent pas comme des programmeurs et développeurs chevronnés. Quel que soit votre niveau d'expérience, nous trouverons 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 questions initiales

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.

1. Avez-vous déjà utilisé BeeWare ?

Si ce n'est pas le cas, commencez par suivre le tutoriel BeeWare. Il vous donnera une introduction au projet BeeWare et à la manière dont les différents éléments du projet s'articulent entre eux. Si vous rencontrez des problèmes en suivant le tutoriel, prenez des notes, car s'assurer que personne d'autre ne rencontre le même problème est un excellent sujet pour une première contribution !

Une fois que vous avez terminé le tutoriel jusqu'à l'étape 4 au moins, passez à la question suivante.

1. De quel matériel informatique disposez-vous ?

Le matériel dont vous disposez limite concrètement votre contribution. Par exemple, si vous avez un ordinateur portable Windows, vous ne pourrez pas travailler sur quoi que ce soit en rapport avec iOS. Votre ordinateur portable fonctionne-t-il sous Windows, macOS, Linux ou autre ? Votre téléphone est-il un appareil iOS ou Android ? Vos appareils vous ont-ils été fournis par votre employeur ou s'agit-il de vos appareils personnels ?

1. Quelle est votre expérience en matière de programmation Python ?

Vous débutez en programmation ? Vous êtes un expert en Python ? Vous êtes un expert en codage qui vient de commencer à apprendre Python ? Vous venez d'obtenir votre diplôme à l'issue d'un programme intensif ? Nous voulons trouver un problème qui correspond à votre niveau d'expérience.

1. Connaissez-vous les processus de contribution GitHub ?

Utilisez-vous GitHub (ou un site similaire de partage de code) pour héberger votre propre code ou contribuer à des projets d'autres personnes ? Savez-vous ce qu'est l'intégration continue (CI) ? Avez-vous déjà contribué à un projet qui utilise des hooks pré-commit ? Si je vous demandais de « rebase votre PR par rapport au main », sauriez-vous quoi faire ?

1. 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 utiliser GitHub pour créer une pull request ?

1. Avez-vous d'autres compétences particulières qui pourraient être utiles ?

Connaissez-vous une API GUI (telle que WinForms, Cocoa ou GTK) ? Avez-vous une connaissance approfondie du fonctionnement interne d'un système d'exploitation particulier ? Êtes-vous expert dans un langage de programmation autre que Python ? Si vous ne possédez aucune compétence particulière, ce n'est pas un problème, mais si nous avons un expert Windows parmi nous, nous voulons nous assurer que ses compétences sont mises à profit.

1. Pourquoi nous avez-vous rejoints et qu'est-ce qui vous intéresse ?

« Vous sembliez être un projet sympathique » est une réponse tout à fait acceptable. Cependant, si vous avez d'autres raisons de nous rejoindre aujourd'hui, n'hésitez pas à nous en faire part. Êtes-vous intéressé par le développement mobile ou desktop ? Le packaging ? Les sites web ? Les applications console ? Si vous n'avez pas d'intérêt particulier, qu'est-ce qui vous semble le plus intéressant d'après ce que vous avez vu de BeeWare 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 numéro

Si vous avez parlé à un membre de l'équipe Bee, il vous a probablement indiqué une partie du projet BeeWare à laquelle vous pouvez contribuer ; il vous a peut-être même suggéré un problème spécifique sur lequel travailler. S'il ne vous a pas donné de problème spécifique, il vous a probablement renvoyé vers les « Good First Issues » (bons premiers problèmes) 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 d'issues GitHub à l'aide du label « good first issue », procédez comme suit :

1. Cliquez sur le bouton « Étiquettes » situé au-dessus de la liste des problèmes pour activer le menu déroulant.
2. Tapez le mot « bon » dans la zone de recherche en haut du menu déroulant.
3. Cliquez sur « bon premier numéro » dans la liste filtrée.

Filtrer les problèmes GitHub par le label « good first issue » (bon premier problème).

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.

Configurer 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 :

• Briefcase
• Toga
• 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 après avoir soumis ma demande de permis de séjour permanent ?

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 la PR aura été approuvée, votre réviseur fusionnera la PR, et vous aurez terminé ! Félicitations, vous avez contribué à BeeWare ! S'il s'agit de votre toute première contribution à BeeWare, vous avez également gagné votre BeeWare Challenge Coin : trouvez un membre de l'équipe principale, et il vous remettra une pièce !

Au secours ! 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.

Que se passe-t-il si je ne termine pas ma contribution pendant le sprint ?

Pas de problème ! Vous pouvez soumettre une contribution à tout moment. L'un des objectifs des sprints est de vous encourager et de vous donner les moyens de continuer à contribuer tout au long de l'année. L'équipe Bee est à votre disposition pour vous aider à chaque étape de ce processus.

Si vous travailliez déjà sur un ticket GitHub ou aviez soumis une demande de tirage, vous pouvez continuer à communiquer via GitHub. Si vous avez d'autres questions ou avez besoin d'aide en temps réel, le meilleur endroit pour nous trouver est le serveur Discord BeeWare. Nous sommes impatients de continuer à travailler avec vous !

Améliorer ce guide

Si vous avez des suggestions pour améliorer ce guide du sprint, n'hésitez pas à nous en faire part. Qu'est-ce qui a fonctionné pour vous ? Qu'est-ce qui n'a pas fonctionné ? Que pouvons-nous améliorer ? Et n'oubliez pas : résoudre un problème avec ce guide de sprint compte comme une contribution à BeeWare !