Les libellés sont une fonctionnalité intéressante de GitHub qui vous permet de filtrer les problèmes et les demandes d'extraction. Ils vous aident à trouver un projet amusant qui correspond à votre niveau d'expérience.
Pour nos dépôts, l'ajout de nouvelles étiquettes aux problèmes est géré exclusivement par l'équipe principale de Blockly, afin de s'assurer que les éléments ne se retrouvent pas au mauvais endroit.
Taille
Certains problèmes sont simples et beaux, tandis que d'autres peuvent prendre des semaines à résoudre. Ces libellés vous aident à évaluer la charge de travail que représente un problème.
- Bon premier problème : ces problèmes sont idéaux pour les personnes qui découvrent le dépôt. Elles devraient prendre moins d'une demi-journée de travail et nécessiter une connaissance limitée de la base de code. Vous pouvez commencer à résoudre ces problèmes immédiatement, sans l'approbation de l'équipe.
Juridiction
Travailler sur un dépôt largement utilisé peut être un processus délicat, et certains problèmes peuvent être plus sensibles que d'autres. Ces libellés vous aident à identifier les problèmes ouverts aux contributions et ceux à éviter.
- Besoin d'aide : ces problèmes sont réservés aux contributeurs. Il s'agit souvent de fonctionnalités que l'équipe principale juge utiles, mais qu'elle n'a pas le temps d'implémenter. Ils peuvent avoir besoin d'une discussion ou d'une implémentation. Vérifiez donc le libellé d'état pour savoir quel travail est nécessaire. C'est un bon endroit pour trouver des projets créatifs amusants.
- Interne : ces problèmes sont réservés aux membres de l'équipe principale. Il s'agit souvent de bugs sensibles ou complexes qui nécessitent une discussion spécifique. Il est préférable de les éviter, car la situation peut évoluer rapidement.
- Aucun : les contributeurs et les membres de l'équipe principale peuvent résoudre les problèmes qui ne sont associés à aucun libellé. Si vous voyez un problème sans libellé qui vous semble intéressant, n'hésitez pas à le prendre en charge.
État
Certains problèmes (en particulier les demandes de fonctionnalités) passent par plusieurs étapes avant d'être considérés comme "résolus". Ces libellés vous indiquent l'état actuel d'un problème afin que vous sachiez ce qu'il faut faire ensuite.
- Discussion : ces problèmes sont en phase de discussion, ce qui signifie que des questions doivent encore être résolues avant l'implémentation. Si vous avez des commentaires à ce sujet, n'hésitez pas à les laisser ci-dessous. Nous sommes toujours à la recherche de nouvelles informations.
- Implémentation : ces problèmes ont été suffisamment discutés pour être clairement définis et sont passés à la phase d'implémentation. Elles sont en attente d'implémentation ou sont déjà en cours d'implémentation. Si vous souhaitez travailler sur l'un d'eux, lisez l'intégralité du problème, puis laissez un commentaire indiquant la partie sur laquelle vous souhaitez travailler, puis lancez-vous !
- Aucun : les problèmes sans libellé peuvent être dans l'un ou l'autre état. Si vous avez une opinion sur la façon dont le problème doit être résolu, n'hésitez pas à laisser un commentaire. Si vous souhaitez travailler sur le problème, il est préférable de laisser un commentaire pour demander s'il est prêt à être implémenté.
Type
Différents problèmes nécessitent des réponses différentes. Certains ne nécessitent que quelques lignes de code, tandis que d'autres nécessitent beaucoup de conception et de discussion. Ces libellés vous indiquent le type d'action à effectuer pour résoudre un problème.
- Bug : ces problèmes documentent un problème lié au codebase. Il faut souvent un peu de débogage pour diagnostiquer la cause du problème, mais certains peuvent être résolus en un clin d'œil. Si vous aimez creuser en profondeur pour comprendre le fonctionnement du code, ces problèmes vous conviendront parfaitement. Vous pouvez nous aider en corrigeant le bug ou en cherchant à comprendre le problème et en rédigeant une explication claire de sa cause première.
- Demande de fonctionnalité : ces problèmes documentent une fonctionnalité que quelqu'un aimerait voir ajoutée. Cela peut s'appliquer à l'ensemble du dépôt ou à un projet individuel. Si vous aimez développer des idées de conception et ajouter de nouvelles fonctionnalités, ces problèmes peuvent être parfaits pour vous.
- Question : Ces problèmes documentent une question qu'une personne se pose sur la base de code. En général, ces questions sont redirigées vers le forum des développeurs. Toutefois, si vous voyez une question à laquelle vous pensez pouvoir répondre, n'hésitez pas à intervenir et à y répondre.
Catégorie
Ce dépôt contient différents types de projets, avec différents types d'audiences cibles. Si vous êtes passionné par les tutoriels ou que vous aimez travailler sur les plug-ins, ces libellés peuvent vous aider à trouver les problèmes qui vous intéressent.
- Codelab : ces problèmes concernent les ateliers de programmation Blockly, une suite de tutoriels interactifs.
- Exemple : Ces problèmes concernent les exemples Blockly, un ensemble de démonstrations autonomes montrant comment inclure et étendre Blockly.
- Plug-in : ces problèmes concernent les plug-ins Blockly, une collection d'extensions qui ajoutent des fonctionnalités à Blockly.
Projet
Si vous souhaitez être encore plus précis, vous pouvez également utiliser des tags pour des projets individuels. Elles sont généralement créées pour les plug-ins, qui ont tendance à présenter plus de problèmes, mais elles peuvent également être créées pour les ateliers de programmation et les exemples. Si vous êtes intéressé par un projet en particulier, ces libellés peuvent vous aider à trouver les problèmes qui y sont liés.
Pour savoir si un libellé existe pour le projet qui vous intéresse, consultez la liste complète des libellés :
Autre
Comme pour toute collection d'éléments, il existe quelques exceptions que vous devez également connaître. Ces libellés ne sont peut-être pas aussi utiles lorsque vous recherchez un problème sur lequel travailler, mais ils peuvent tout de même être informatifs.
- Tri : ces problèmes n'ont pas encore été correctement étiquetés par l'équipe principale. Les problèmes associés à ce libellé peuvent déjà inclure un autre libellé simple tel que bug ou demande de fonctionnalité, mais d'autres libellés seront probablement ajoutés prochainement.
- Doublon : ces problèmes documentent un problème, une demande ou une question qui sont déjà couverts par un autre problème. Ce libellé indique que vous ne devez pas répondre à ce problème, mais plutôt au problème d'origine.