Guide de contribution¶

Il existe de nombreuses façons de contribuer à BeeWare. Ces guides couvrent tout ce que vous devez savoir pour apporter votre contribution.

Que puis-je faire ?¶

Résoudre un problème ¶

La contribution la plus évidente que vous pouvez apporter est d'écrire du code pour résoudre un problème connu.

Mettre en œuvre une nouvelle fonctionnalité ¶

Est-ce qu'il manque une fonctionnalité à BeeWare que vous aimeriez voir apparaître ? Vous pouvez mettre en place une nouvelle fonctionnalité.

Write documentation ¶

Aucune fonctionnalité n'est complète tant qu'elle n'est pas bien documentée. Écrire de la documentation est une façon de contribuer qui n'implique pas d'écrire du code.

Chaque fois que quelqu'un signale un nouveau problème, celui-ci doit être trié. Le triage d'un problème consiste à prendre les informations fournies par le rapporteur et à essayer de reproduire le problème qu'il décrit.

Examiner une demande d'extraction ¶

Une fois qu'une demande d'extraction est soumise, elle doit être examinée avant d'être fusionnée. Que vous soyez ou non très familier avec le contenu, il y a probablement un moyen d'aider à la révision d'une demande d'extraction.

Suggérer une nouvelle fonctionnalité ¶

Avez-vous une suggestion ou une idée pour un nouvel ajout à l'un des outils BeeWare ? Vous pouvez proposer une nouvelle fonctionnalité pour examen.

Traduire le contenu ¶

BeeWare propose une documentation en plusieurs langues. Si vous connaissez une autre langue que l'anglais, vous pouvez aider à traduire le contenu.

Utiliser les outils ¶

Vous avez une idée d'application construite avec Toga ? Avez-vous une application existante qui pourrait être intégrée à Briefcase ? Vous pouvez utiliser les outils et donner votre avis sur votre expérience.

Comment puis-je contribuer ?¶

Créer un environnement de développement ¶

Avant de commencer à contribuer à BeeWare, vous devez mettre en place votre environnement de développement.

Reproduire un problème ¶

Avant de résoudre un problème, vous devez vérifier qu'il existe. La reproduction d'un problème est également un élément important du triage.

Travailler à partir d'une branche ¶

Lorsque vous vous préparez à soumettre une contribution, travaillez toujours à partir d'une branche.

Éviter les dérives ¶

Il est important de rester concentré et d'éviter les dérives dans votre contribution.

Proposer une nouvelle fonctionnalité ¶

Vous suivrez les étapes suivantes pour proposer une nouvelle fonctionnalité.

Écrire, exécuter et tester le code ¶

Pour mettre à jour ou contribuer au code, vous devez écrire, exécuter et tester votre code.

Documentation sur la construction ¶

Pour mettre à jour la documentation ou y contribuer, vous devez être en mesure de construire la documentation.

Write documentation ¶

Pour contribuer à la documentation, vous devez rédiger un nouveau contenu ou mettre à jour un contenu existant.

Ajouter une note de modification ¶

Chaque demande d'extraction devrait être accompagnée d'une note de changement.

Soumettre une demande d'extraction ¶

Une fois que vos modifications sont prêtes, vous soumettez une demande d'extraction pour examen.

Donner un avis ¶

Si vous vous sentez à l'aise, vous pouvez donner votre avis sur la contribution de quelqu'un d'autre.

Traduire le contenu ¶

BeeWare utilise Weblate pour les traductions, ce qui nécessite quelques étapes pour commencer.

Soumettre un nouveau numéro ¶

Si vous rencontrez un nouveau problème ou un nouveau bogue, il est utile de soumettre un problème.

Que se passe-t-il ensuite ?¶

Révision de la demande d'extraction ¶

Lorsqu'une demande d'extraction est soumise, l'étape suivante est la révision des RP.

Le processus de libération ¶

Les contributions fusionnées seront soumises au processus de publication.

Style Guides¶

Code style guide ¶

Voici les règles à suivre pour contribuer au code des projets BeeWare.

Documentation style guide ¶

Voici les règles à suivre pour contribuer à la documentation des projets BeeWare.