Article surtout destiné aux développeurs junior

S’entraider, concrètement

En tant que développeur junior ou aspirant développeur, partir à la recherche d’une aide salvatrice pour un bout de code tortueux est inévitable. On ne devient pas un bon développeur qu’à coup de bouquins et de documentations techniques, mais aussi avec de francs coups de main.

Harceler les moteurs de recherche, Qwant étant notre favori à tous n’est-ce pas, est utile et suffit dans la majorité des situations. Mais il y a-t-il autre chose ? Pouvons-nous nous entraider en cumulant :

  • Une aide précise sur le code.
  • Des conseils sur comment mieux rédiger son code ou gérer un problème.
  • Pouvoir discuter facilement sur un problème parmi les nombreux (inutile de le cacher, on débute, alors on bute).

Faire une demande est très simple et rapide, comme y répondre.

En plus, cerise sur le gâteau, les reviews apparaissent sur votre profil GitHub : Mamie Bon-conseil-startup-innovation-LinkedIn ne cache pas son entrain là !

Vous souhaitez donner quelques minutes pour aider des débutants ? Partagez votre pseudo en commentaire sous cette forme : pseudo [langages et/ou technos].

Vous souhaitez de l’aide ? Continuez de lire cet article, et assignez les gentils bénévoles trouvés dans les commentaires.

GitHub et son système de code review

C’est trop facile, trop pratique, mais trop peu de personnes l’utilisent pour apprendre et partager ses connaissances : le code review.

En vrai, ça va…

Je vais expliquer ici comment faire une demande super facile pour que des gens super gentils vous filent un coup de pouce super appréciable.

Dès que j’aurais moi-même reçu une demande de review, j’expliquerais comment ça se passe pas à pas ici-même.

Si vous ne connaissez rien à Git et GitHub, je vous recommande ce cours Openclassrooms Gérez votre code avec Git et GitHub.

Créer un pull request, brièvement

  • git push votre nouvelle branche avec les modifications liées au code à mettre en évidence > dans votre repository
  • new pull request
  • partager le lien ou assigner des utilisateurs de GitHub avec leur pseudo.

Créer un pull request, en détails

Appelons méchant code la ou les parties du code que vous souhaitez soumettre à l’avis de vos confrères et consœurs développeurs.

Commencez par créer une branche dédiée à votre méchant code  (choisissez un nom contextuel) :
git checkout -b nouvelle-branche

Le code modifié ici sera celui mis en avant dans votre code review. Vous pouvez par exemple commenter votre méchant code pour le mettre en évidence.

Puis mettez le tout en ligne :
git add .
git commit -m "mes modifications contextualisées"
git push origin nouvelle-branche

Rendez-vous dans votre repository, dans la branche que vous souhaitez transmettre pour un review :

Puis cliquez sur New pull request :

Expliquez simplement et de façon concise votre problème ou l’avis que vous souhaitez avoir :

Puis, si vous scrollez un peu plus bas, vous verrez justement vos modifications précédemment réalisées : votre méchant code !

Créez votre pull request et admirez le travail !

Comment demander de l’aide ?

Vous pouvez partager le lien très simplement, ou même, vous pouvez assigner des utilisateurs de GitHub avec leur pseudo comme vous pouvez le voir ci-dessous à droite :

Deux-trois choses sur le pull request

  • L’onglet Conversation est dédié aux échanges autour de votre code. Dans l’idée, on ne demande pas à ce que des bonnes poires corrigent votre code eux-même : on souhaite qu’ils regardent brièvement et émettent un avis pour vous guider vers la bonne voie !
  • L’onglet Commits présente tous les commits de la branche, et puisque vous nommez toujours avec contexte vos commits (n’est-ce pas?) c’est super pratique pour suivre votre avancée !
  • L’onglet Checks… on évite pour l’instant. *regard fuyant*
  • L’onglet Files Changed présente les modifications réalisées au dernier commit : super précis, direct, rapide : bref, ça permet facilement à tout le monde de voir dans votre code où se porte votre malheur.

Conclusion

N’hésitez pas à me demander une review concernant JavaScript, mon pseudo sur GitHub est tobudim. J’utiliserai cette fonctionnalité pour approfondir mes connaissances, c’est win-win-win !