1
00:00:05,440 --> 00:00:11,040
Comment rédiger un bon ticket sur GitHub ? GitHub est l'endroit principal pour les

2
00:00:11,040 --> 00:00:15,920
bibliothèques open source de Hugging Face, et vous devriez toujours vous y rendre pour signaler un bogue ou demander une nouvelle fonctionnalité. Pour

3
00:00:15,920 --> 00:00:21,680
des questions plus générales ou pour déboguer votre propre code, utilisez les forums (voir la vidéo ci-dessous). Il est

4
00:00:21,680 --> 00:00:25,920
très important d'écrire de bons tickets, car cela aidera le bogue que vous avez découvert à être corrigé en un rien de temps.

5
00:00:26,960 --> 00:00:31,760
Pour cette vidéo, nous avons créé une version de Transformers avec un bogue. Vous pouvez l'installer en

6
00:00:31,760 --> 00:00:36,080
exécutant cette commande dans un notebook (supprimez le point d'exclamation pour l'exécuter dans un terminal).

7
00:00:37,040 --> 00:00:43,440
Dans cette version, l'exemple suivant échoue. L'erreur est plutôt énigmatique et ne semble pas provenir

8
00:00:43,440 --> 00:00:49,600
de quoi que ce soit dans notre code. Il semble donc que nous ayons un bogue à signaler ! Dans ce cas, la première chose à faire

9
00:00:49,600 --> 00:00:53,200
est d'essayer de trouver la plus petite quantité de code possible reproduisant le bogue.

10
00:00:54,000 --> 00:00:59,680
Dans notre cas, en inspectant le « Traceback », nous constatons que l'échec se produit à l'intérieur de la fonction pipeline

11
00:00:59,680 --> 00:01:06,400
lorsqu'elle appelle `AutoTokenizer.from_pretrained`. À l'aide du débogueur, nous trouvons les valeurs transmises à cette méthode

12
00:01:06,400 --> 00:01:11,840
et pouvons ainsi créer un petit échantillon de code qui, espérons-le, génère la même erreur.

13
00:01:12,560 --> 00:01:16,800
Il est très important de suivre cette étape car vous pouvez réaliser que l'erreur était de votre côté et non

14
00:01:16,800 --> 00:01:21,280
un bogue dans la bibliothèque, mais cela permettra également aux responsables de résoudre plus facilement votre problème.

15
00:01:22,080 --> 00:01:24,880
Ici, nous pouvons jouer un peu plus avec ce code et remarquer que l'erreur se produit

16
00:01:24,880 --> 00:01:31,040
pour différents checkpoints et pas seulement celui-ci, et qu'elle disparaît lorsque nous utilisons `use_fast=False`

17
00:01:31,040 --> 00:01:36,400
dans notre appel de tokenizer. L'important est d'avoir quelque chose qui ne dépend d'aucun

18
00:01:36,400 --> 00:01:42,800
fichier ou donnée externe. Essayez de remplacer vos données par de fausses valeurs si vous ne pouvez pas les partager. Avec

19
00:01:42,800 --> 00:01:48,480
tout cela fait, nous sommes prêts à commencer à écrire notre ticket. Cliquez sur le bouton à côté de « Bug Report » et

20
00:01:48,480 --> 00:01:54,160
vous découvrirez qu'il y a un patron à remplir. Cela ne vous prendra que quelques minutes. La première

21
00:01:54,160 --> 00:02:00,000
chose à faire est de nommer correctement votre ticket. Ne choisissez pas un titre trop vague ! Ensuite, vous devez remplir

22
00:02:00,000 --> 00:02:04,800
les informations de votre environnement. Il existe une commande fournie par la bibliothèque Transformers pour effectuer cette opération.

23
00:02:05,520 --> 00:02:09,840
Exécutez-la simplement dans votre notebook ou dans un terminal, puis copiez-collez les résultats.

24
00:02:10,800 --> 00:02:15,600
Il reste deux dernières questions à remplir manuellement (auxquelles les réponses sont non et non dans notre cas).

25
00:02:17,440 --> 00:02:23,680
Ensuite, nous devons déterminer qui taguer. Il existe une liste complète des noms d'utilisateur. Étant donné que notre problème

26
00:02:23,680 --> 00:02:28,880
concerne les tokenizers, nous choisissons le responsable qui leur est associé. Inutile de taguer

27
00:02:28,880 --> 00:02:32,640
plus de 3 personnes, elles vous redirigeront vers la bonne personne si vous avez fait une erreur.

28
00:02:34,320 --> 00:02:37,280
Ensuite, nous devons fournir les informations nécessaires pour reproduire le bug.

29
00:02:38,000 --> 00:02:43,280
Nous collons notre exemple et le plaçons entre deux lignes avec trois « backticks » afin qu'il soit

30
00:02:43,280 --> 00:02:49,840
correctement formaté. Nous collons également le « Traceback » complet, toujours entre deux lignes de trois « backticks ». Enfin,

31
00:02:50,400 --> 00:02:54,400
nous pouvons ajouter toute information supplémentaire sur ce que nous avons essayé de déboguer pour le problème en question.

32
00:02:54,960 --> 00:02:58,800
Avec tout cela, vous devriez vous attendre à une réponse assez rapide à votre ticket et, espérons-le, à une solution rapide !

33
00:02:58,800 --> 00:03:03,840
Notez que tous les conseils de cette vidéo s'appliquent à presque tous les projets open source.