Les étiquettes sont une fonctionnalité intéressante de GitHub qui vous permet de filtrer les problèmes et les demandes d'extraction. Ils vous aident à trouver quelque chose d’amusant à travailler qui correspond à votre niveau d’expérience.
Pour nos dépôts, l'ajout de nouveaux libellés aux problèmes est géré exclusivement par l'équipe de base Blockly afin d'éviter toute erreur.
Taille
Certains problèmes sont de petite taille et d'aspect esthétique, tandis que d'autres peuvent mettre des semaines à être vaincus. Ces étiquettes vous aident à indiquer la charge de travail probable d'un problème.
- Premier problème correct:ces problèmes sont particulièrement utiles pour les personnes qui débutent avec le dépôt. Elles devraient prendre moins d'une demi-journée de travail et nécessitent une connaissance limitée du code base. Vous pouvez commencer à travailler sur ces problèmes immédiatement, sans l'approbation de l'équipe.
Juridiction
Travailler sur un dépôt largement utilisé peut être un processus sensible, et certains problèmes peuvent être plus sensibles que d'autres. Ces libellés vous aident à identifier les problèmes pouvant être ajoutés et ceux à éviter.
- Aide requise:ces problèmes sont réservés aux contributeurs. Il s'agit souvent de fonctionnalités que l'équipe principale considère comme utiles, mais n'a pas le temps de les mettre en œuvre. Ils peuvent nécessiter une discussion ou une implémentation. Vous devez donc consulter le libellé d'état pour connaître le travail nécessaire. C'est le 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 particulière. Il est préférable de les éviter, car la situation pourrait changer rapidement.
- Aucun des deux:les problèmes sans libellé peuvent être résolus par les contributeurs et les membres de l'équipe principale. Si vous rencontrez un problème sans étiquette qui vous intéresse, prenez-le en main.
État
Certains problèmes (en particulier les demandes de fonctionnalités) passent par différentes étapes avant d'être considérés comme "fermés". Ces étiquettes vous indiquent à quelle étape se trouve un problème, ce qui vous permet de savoir ce qu'il faut faire ensuite.
- Discussion:ces problèmes sont en phase de discussion, ce qui signifie que des questions doivent encore être traitées avant la mise en œuvre. Si vous avez des commentaires à ce sujet, n'hésitez pas à nous en faire part. Nous sommes toujours à la recherche d'informations supplémentaires.
- Implémentation:ces problèmes ont fait l'objet de suffisamment de discussions 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'entre eux, lisez l'intégralité du problème, puis laissez un commentaire indiquant sur quelle partie vous souhaitez travailler, puis lancez-vous !
- Aucun des deux:les problèmes sans étiquette peuvent se trouver dans l'un ou l'autre des états. Si vous avez un avis sur la façon dont le problème doit être implémenté, n'hésitez pas à laisser un commentaire. Si vous souhaitez travailler sur le problème, il est préférable de laisser un commentaire vous demandant s'il est prêt à être implémenté.
Type
Différents problèmes nécessitent des réponses différentes. Certaines ne nécessitent de modifier que quelques lignes de code, tandis que d'autres nécessitent beaucoup de conception et de discussion. Ces étiquettes vous indiquent le type d'action nécessaire à un problème.
- Bug:ces problèmes documentent un problème lié au codebase. Ils nécessitent souvent un débogage pour identifier 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, sachez que ce sera d'importants problèmes pour vous. Vous pouvez nous aider en corrigeant le bug ou en cherchant à comprendre le problème et en expliquant clairement sa cause.
- Demande de fonctionnalité:ces problèmes permettent de documenter une fonctionnalité qu'un utilisateur aimerait qu'il ajoute. Cela peut s'appliquer au dépôt dans son ensemble ou à un projet individuel. Si vous aimez enrichir les idées de conception et ajouter de nouvelles fonctionnalités, ces problèmes peuvent être la solution idéale pour vous.
- Question: Ces problèmes permettent de documenter une question qu'un utilisateur se pose sur le codebase. En général, ces questions sont redirigées vers le forum des développeurs, mais si vous pensez pouvoir y répondre, n'hésitez pas à 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 si vous aimez travailler sur des plug-ins, ces libellés peuvent vous aider à identifier les problèmes qui vous intéressent.
- Atelier de programmation:Ces problèmes sont liés aux ateliers de programmation Blockly, une suite de tutoriels interactifs.
- Exemple:Ces problèmes sont liés aux exemples Blockly, un ensemble de démonstrations autonomes expliquant comment inclure et étendre Blockly.
- Plug-in:ces problèmes sont liés aux plug-ins Blockly, un ensemble d'extensions qui ajoutent des fonctionnalités à Blockly.
Projet
Si vous souhaitez obtenir encore plus de précision, vous pouvez également ajouter des tags pour des projets individuels. Ils sont généralement créés pour les plug-ins, qui sont généralement associés à davantage de problèmes, mais ils peuvent également être créés pour des ateliers de programmation et des exemples. Si vous êtes intéressé par un projet particulier, ces libellés peuvent vous aider à détecter les problèmes liés à ce projet.
Notez également que de nouveaux projets sont régulièrement ajoutés. Cette liste peut donc devenir obsolète. Si vous ne voyez pas d'entrée correspondant au projet qui vous intéresse, consultez la liste complète des libellés.
- Outils de développement:ces problèmes sont liés au package dev tools, une bibliothèque d'utilitaires courants pour le développement d'extensions Blockly.
- Champ date:ces problèmes sont liés au package champ de date, un champ de sélection de date qui utilise le sélecteur de date de fermeture de Google.
Autre
Comme pour toute collection d'éléments, vous devez également en connaître quelques-uns. Ces libellés peuvent ne pas être aussi utiles lorsque vous recherchez un problème, 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 il est probable que d'autres libellés seront bientôt ajoutés.
- Doublon:ces problèmes documentent un problème, une demande ou une question déjà couvert par un autre problème. Cette étiquette vous indique que vous ne devez pas répondre à ce problème, mais plutôt répondre au problème d'origine.