• 12 heures
  • Facile

Ce cours est visible gratuitement en ligne.

course.header.alt.is_video

course.header.alt.is_certifying

J'ai tout compris !

Mis à jour le 26/08/2019

Gérez les demandes de pull

Connectez-vous ou inscrivez-vous gratuitement pour bénéficier de toutes les fonctionnalités de ce cours !

Pourquoi est-il important de gérer les demandes de pull régulièrement pour maintenir un projet actif ?

En effet, imaginez un peu un ami qui vous propose toutes les semaines de vous inviter à boire un café, à venir manger chez lui, à aller faire une sortie entre amis. Toutes les semaines vous l'ignorez, soit par manque de temps, soit car vous n'avez pas envie. Petit à petit, il ne vous sollicitera plus et ne s’intéressera plus à vous, même s'il vous apprécie beaucoup !

Eh bien, un projet GitHub c'est presque la même chose, il reste intéressant aux yeux des contributeurs uniquement s'il reste actif et que les demandes de pull sont traitées.

Imaginez que vous ayez créé une super fonctionnalité pour un projet open source sur GitHub, que vous ayez passé beaucoup de temps à la développer. Vous faites une pull request et personne ne la traite. Vous avez donc travaillé pour rien ! Et ce n'est jamais agréable d'être ignoré. ;)

Étiquetez votre projet avec des badges

Les badges permettent de garder le projet à jour et indiquent une certaine qualité. Les badges peuvent être utilisés pour tout un tas de choses.

Ils peuvent être utiles :

  • dans le cas de l'intégration continue, par exemple. "Build passing" indique que les tests du projet sont concluants et que le projet est fonctionnel ;

  • dans le cadre de la sécurité. Ce badge indique qu'aucune vulnérabilité n'a été détectée sur votre projet ;

  • pour indiquer que votre code a été testé. Ce badge indique le pourcentage de votre code qui fait l'objet de tests. Il est très utile de créer des scénarios de tests, des tests automatiques, des tests de régression pour afficher un 100 % !

  • pour indiquer aux contributeurs la version de votre module. Cela n'est pas obligatoire, mais peut être apprécié ;

  • pour indiquer la maintenabilité d'un projet. 

Le score obtenu reflète la qualité du code d'un projet mesuré en fonction de plusieurs facteurs, notamment la complexité/simplicité, la lisibilité, la maintenabilité, la répétition et le nombre de lignes par fichier

Il y a encore de nombreux autres badges, mais nous vous avons vu les principaux !

Gérez les corrections de bugs avec la console GitHub

Dans GitHub, il y a un onglet très pratique qui permet de maintenir la gestion des bugs, l'onglet "Issues".

Onglet Issues
Onglet Issues

Les "issues" permettent aux utilisateurs et aux contributeurs d'indiquer des bugs afin qu'ils puissent être corrigés par vous, mais aussi par les autres contributeurs.

Afin de créer un nouveau report de bug, nous devons cliquer sur "New issue".

New issue
New issue

GitHub vous demande alors d'indiquer un nom pour l'issue et un descriptif. Attention, une issue doit correspondre à un bug unique et non à plusieurs bugs.

Exemple issue
Exemple issue

Il est aussi possible d'assigner le bug à quelqu'un pour lui dire de le résoudre. Par exemple, vous travaillez en équipe. Vous êtes sur la partie frontend et votre collègue sur la partie backend ; si l'envoi de mail ne fonctionne plus, c'est à votre collègue de s'en charger. Vous pouvez donc lui assigner l'issue. Si au contraire, un utilisateur rencontre un bug d'affichage, vous pouvez vous assigner le bug.

Une fois le bug résolu, il est très important de passer l'issue au statut "clos". Cela évite que quelqu'un travaille dessus inutilement, et puis c'est toujours mieux d'avoir le minimum de bugs sur votre projet. :)

Quand devriez-vous fusionner dans la branche principale ?

Vous vous demandez sûrement comment être sûr de ne pas fusionner n'importe quoi sur votre branche principale.

Tout d'abord, vous devez bien entendu regarder ce que l'on vous a transmis.

Ensuite, sur des projets plus conséquents, vous pouvez indiquer un nombre minimum d'approbations (par les autres contributeurs), avant d'avoir la possibilité de fusionner.

Nous avons désormais fait le tour des commandes de base de Git et du fonctionnement de GitHub. Faisons un petit récapitulatif de nos connaissances !

Exemple de certificat de réussite
Exemple de certificat de réussite