{"id":5114,"date":"2025-07-21T14:43:13","date_gmt":"2025-07-21T14:43:13","guid":{"rendered":"https:\/\/techhub.saworks.io\/docs\/tutoriel-github\/les-bases-de-github-partie-2-sur-2\/exercice-creez-votre-premiere-pull-request\/"},"modified":"2025-11-07T11:43:06","modified_gmt":"2025-11-07T11:43:06","slug":"exercice-creez-votre-premiere-pull-request","status":"publish","type":"docs","link":"https:\/\/techhub.saworks.io\/fr\/docs\/tutoriel-github\/les-bases-de-github-partie-2-sur-2\/exercice-creez-votre-premiere-pull-request\/","title":{"rendered":"Exercice \u2013 Cr\u00e9ez votre premi\u00e8re pull request"},"content":{"rendered":"\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<p>Vous avez appris \u00e0 cr\u00e9er une&nbsp;<em>pull request<\/em>&nbsp;(PR) lorsqu\u2019il existe des indications, soit dans un mod\u00e8le de PR, soit dans un fichier&nbsp;<strong>CONTRIBUTING<\/strong>. Mais que faire si un projet ne fournit pas ces indications ni de documentation sur les conventions \u00e0 suivre ?<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>D\u00e9crivez vos modifications<\/strong><\/h3>\n\n\n\n<p>Pour r\u00e9diger un bon message de&nbsp;<em>commit<\/em>, et par cons\u00e9quent une bonne&nbsp;<em>pull request<\/em>, suivez ces bonnes pratiques :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>La ligne d\u2019objet de votre message de&nbsp;<em>commit<\/em>&nbsp;Git doit compl\u00e9ter la phrase suivante :<br><strong>Si elle est appliqu\u00e9e, cette modification va :&nbsp;<em>&lt;votre ligne d\u2019objet ici&gt;<\/em><\/strong>.<\/li>\n\n\n\n<li>Incluez une description concise du changement en utilisant l\u2019<strong>imp\u00e9ratif au pr\u00e9sent<\/strong>. Par exemple, utilisez&nbsp;<strong>ajoute<\/strong>&nbsp;plut\u00f4t que&nbsp;<strong>ajout\u00e9<\/strong>&nbsp;ou&nbsp;<strong>ajoute<\/strong>.<\/li>\n\n\n\n<li>Limitez votre ligne d\u2019objet \u00e0&nbsp;<strong>50 caract\u00e8res<\/strong>.<\/li>\n\n\n\n<li>Commencez par une&nbsp;<strong>majuscule<\/strong>, et&nbsp;<strong>ne terminez pas par un point<\/strong>.<\/li>\n\n\n\n<li>Vous pouvez utiliser des&nbsp;<strong>\u00e9mojis<\/strong>&nbsp;dans votre ligne d\u2019objet et mentionner d\u2019autres utilisateurs GitHub avec&nbsp;<code>@<\/code>, mais tout le monde n\u2019appr\u00e9cie pas forc\u00e9ment ce style plus l\u00e9ger.<\/li>\n<\/ul>\n\n\n\n<p>Pour le&nbsp;<strong>corps du message<\/strong>&nbsp;et la description de la&nbsp;<em>pull request<\/em>, continuez \u00e0 utiliser le&nbsp;<strong>pr\u00e9sent<\/strong>. Assurez-vous d\u2019inclure la&nbsp;<strong>motivation<\/strong>&nbsp;du changement. Comparez votre modification avec le comportement pr\u00e9c\u00e9dent. Utilisez l\u2019espace disponible pour expliquer&nbsp;<strong>le quoi et le pourquoi<\/strong>, plut\u00f4t que&nbsp;<strong>le comment<\/strong>.<\/p>\n\n\n\n<p>Votre message de&nbsp;<em>commit<\/em>&nbsp;doit \u00eatre aussi clair et pr\u00e9cis que le contenu que vous soumettez. Soumettez de&nbsp;<strong>petits ensembles de modifications isol\u00e9es<\/strong>. Cette pratique augmente les chances que vos changements soient int\u00e9gr\u00e9s au projet.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Ajoutez de la granularit\u00e9<\/strong><\/h3>\n\n\n\n<p>Avant de soumettre votre&nbsp;<em>pull request<\/em>, v\u00e9rifiez la barre lat\u00e9rale pour voir comment la compl\u00e9ter :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>S\u00e9lectionnez&nbsp;<strong>Reviewers<\/strong>&nbsp;ou&nbsp;<strong>Assignees<\/strong>&nbsp;si vous connaissez la structure de l\u2019\u00e9quipe du projet.<\/li>\n\n\n\n<li>Ajoutez des&nbsp;<strong>\u00e9tiquettes<\/strong>&nbsp;(<em>labels<\/em>) s\u2019il y a des indications \u00e0 ce sujet dans le fichier&nbsp;<code>CONTRIBUTING.md<\/code>. Les \u00e9tiquettes servent d\u2019indices visuels sur ce que vous essayez d\u2019accomplir. Un mainteneur peut aussi ajouter une ou plusieurs \u00e9tiquettes.<\/li>\n<\/ul>\n\n\n\n<p>Voici quelques \u00e9tiquettes utilis\u00e9es dans le d\u00e9p\u00f4t de ce module Learn :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Bug<\/strong>&nbsp;(rouge) : Quelque chose ne fonctionne pas<\/li>\n\n\n\n<li><strong>Documentation<\/strong>&nbsp;(bleu) : Am\u00e9liorations ou ajouts \u00e0 la documentation<\/li>\n\n\n\n<li><strong>Duplicate<\/strong>&nbsp;(gris) : Ce ticket ou cette&nbsp;<em>pull request<\/em>&nbsp;existe d\u00e9j\u00e0<\/li>\n\n\n\n<li><strong>Enhancement<\/strong>&nbsp;(bleu-vert) : Nouvelle fonctionnalit\u00e9 ou demande<\/li>\n<\/ul>\n\n\n\n<p>Vous pouvez \u00e9galement&nbsp;<strong>lier des tickets<\/strong>&nbsp;dans la barre lat\u00e9rale, afin que la fusion de la&nbsp;<em>pull request<\/em>&nbsp;ferme automatiquement le ticket correspondant.<br>Vous pouvez aussi&nbsp;<strong>personnaliser votre abonnement aux notifications<\/strong>&nbsp;du fil de discussion. Certaines PR re\u00e7oivent de nombreux commentaires, revues et notifications li\u00e9es \u00e0 l\u2019int\u00e9gration continue (CI\/CD). Vous pouvez choisir parmi :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Not subscribed<\/strong>&nbsp;: Vous ne recevez des notifications que si vous avez particip\u00e9 ou \u00e9t\u00e9 mentionn\u00e9 avec&nbsp;<code>@<\/code>.<\/li>\n\n\n\n<li><strong>Subscribed<\/strong>&nbsp;: Vous recevez toutes les notifications de cette&nbsp;<em>pull request<\/em>.<\/li>\n\n\n\n<li><strong>Custom<\/strong>&nbsp;: Vous \u00eates notifi\u00e9 uniquement pour les \u00e9v\u00e9nements que vous s\u00e9lectionnez.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Exercice<\/strong><\/h3>\n\n\n\n<p>En utilisant le projet&nbsp;<strong><a href=\"https:\/\/github.com\/firstcontributions\/first-contributions\">First Contributions<\/a><\/strong>, entra\u00eenez-vous \u00e0&nbsp;<em>forker<\/em>,&nbsp;<em>cloner<\/em>&nbsp;et soumettre une&nbsp;<em>pull request<\/em>.<br>Le projet&nbsp;<strong>First Contributions<\/strong>&nbsp;a pour but de \u00ab guider les d\u00e9butants dans la r\u00e9alisation de leur premi\u00e8re contribution \u00bb. Il propose des guides pour l\u2019utilisation de la ligne de commande ainsi que de plusieurs interfaces graphiques (GUI). Le projet prend \u00e9galement en charge plusieurs langues. N\u2019oubliez pas de consulter le dossier&nbsp;<strong>Translations<\/strong>.<\/p>\n\n\n\n<p>Avec les le\u00e7ons des unit\u00e9s pr\u00e9c\u00e9dentes et de celle-ci en t\u00eate, retournez \u00e0 une&nbsp;<em>pull request<\/em>&nbsp;que vous avez r\u00e9cemment ouverte. Ou bien, allez dans l\u2019onglet&nbsp;<strong>Pull requests<\/strong>&nbsp;d\u2019un projet que vous suivez. Observez comment un bon titre peut faire toute la diff\u00e9rence. Envisagez de mettre \u00e0 jour une&nbsp;<em>pull request<\/em>&nbsp;en cons\u00e9quence. Consacrez \u00e0 la r\u00e9daction de votre PR autant de soin que vous en avez mis dans la modification du projet. Vos efforts aideront les mainteneurs \u00e0&nbsp;<strong>cat\u00e9goriser et prioriser<\/strong>&nbsp;les contributions de la communaut\u00e9.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Bonus<\/strong><\/h3>\n\n\n\n<p><br>Les utilisateurs interagissent avec les produits via diff\u00e9rents moyens : clavier, souris, \u00e9cran tactile, commande vocale, etc. Il est donc pr\u00e9f\u00e9rable d\u2019utiliser des&nbsp;<strong>verbes g\u00e9n\u00e9riques<\/strong>&nbsp;qui conviennent \u00e0 tous les types d\u2019interaction. Par exemple, utilisez&nbsp;<strong>s\u00e9lectionner<\/strong>&nbsp;au lieu de&nbsp;<strong>cliquer<\/strong>&nbsp;ou&nbsp;<strong>glisser<\/strong>.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Vous avez appris \u00e0 cr\u00e9er une&nbsp;pull request&nbsp;(PR) lorsqu\u2019il existe des indications, soit dans un mod\u00e8le de PR, soit dans un fichier&nbsp;CONTRIBUTING. Mais que [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":5062,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-5114","docs","type-docs","status-publish","hentry"],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/6a70e7c73db9f245e650948d09d74f61?s=96&d=mm&r=g","author_name":"Annick N'dri","_links":{"self":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/5114"}],"collection":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/comments?post=5114"}],"version-history":[{"count":0,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/5114\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/5062"}],"wp:attachment":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/media?parent=5114"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/doc_tag?post=5114"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/doc_badge?post=5114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}