{"id":229722,"date":"2022-11-11T10:52:00","date_gmt":"2022-11-11T07:52:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229722"},"modified":"2022-11-09T16:06:10","modified_gmt":"2022-11-09T13:06:10","slug":"comment-utiliser-les-modeles-de-relations-publiques-github","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/comment-utiliser-les-modeles-de-relations-publiques-github\/","title":{"rendered":"Comment utiliser les mod\u00e8les de relations publiques GitHub"},"content":{"rendered":"\n<p>Si vous faites un travail &#8211; qu&rsquo;il soit open source ou ferm\u00e9 &#8211; (bien que je sache que la plupart de ceux qui lisent ce site sont impliqu\u00e9s dans l&rsquo;open source), vous utilisez probablement un contr\u00f4le de source, et c&rsquo;est probablement GitHub.<\/p>\n<p>Pour beaucoup d&rsquo;entre vous, vous suivez un projet, contribuez \u00e0 un projet ou g\u00e9rez des pull requests \u00e0 un projet. Et qu&rsquo;en est-il des projets sur lesquels vous travaillez en \u00e9quipe ?<\/p>\n<p>Peut-\u00eatre que votre flux de travail ressemble \u00e0 ceci\u00a0:<\/p>\n<ul>\n<li>vous cr\u00e9ez une branche pour travailler sur une fonctionnalit\u00e9,<\/li>\n<li>vous poussez la branche pour d\u00e9tailler le travail que vous avez fait pour qu&rsquo;un pair l&rsquo;examine,<\/li>\n<li>l&rsquo;avis est fusionn\u00e9,<\/li>\n<li>continue.<\/li>\n<\/ul>\n<p>Mais que mettez-vous dans le mod\u00e8le de pull request\u00a0? Est-ce la m\u00eame chose \u00e0 chaque fois ou est-ce diff\u00e9rent? Qu&rsquo;en est-il si le contenu du PR est li\u00e9 \u00e0 quelque chose dans <a href=\"https:\/\/trello.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Trello<\/a>, <a href=\"https:\/\/asana.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Asana<\/a>, <a href=\"https:\/\/basecamp.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Basecamp<\/a> ou un autre syst\u00e8me de gestion de projet ?<\/p>\n<p>C&rsquo;est l\u00e0 que les mod\u00e8les GitHub PR entrent en jeu.<\/p>\n<h2>Mod\u00e8les de relations publiques GitHub<\/h2>\n<p>Vous pouvez tout lire \u00e0 leur sujet sur la page, mais voici l&rsquo;essentiel (sans jeu de mots):<\/p>\n<blockquote>\n<p>Il est difficile de r\u00e9soudre un probl\u00e8me lorsqu&rsquo;il manque des d\u00e9tails importants. D\u00e9sormais, les responsables de projets peuvent ajouter des mod\u00e8les pour les probl\u00e8mes et les demandes d&rsquo;extraction aux projets, aidant ainsi les contributeurs \u00e0 partager les bons d\u00e9tails au d\u00e9but d&rsquo;un fil de discussion.<\/p>\n<\/blockquote>\n<p>Et l&rsquo;id\u00e9e est simple\u00a0: nous cr\u00e9ons des mod\u00e8les pour les probl\u00e8mes et les demandes d&rsquo;extraction pour les autres qui fournissent un niveau d&rsquo;informations qu&rsquo;ils doivent remplir avant de soumettre un probl\u00e8me ou une demande d&rsquo;extraction.<\/p>\n<p>Cela nous aide, car les mainteneurs connaissent toutes les informations dont nous avons besoin avant de les examiner. De plus, cela peut nous permettre d&rsquo;\u00e9tablir un lien vers un probl\u00e8me pr\u00e9c\u00e9dent, un ticket pr\u00e9c\u00e9dent, avant tout ce qui concerne le projet.<\/p>\n<p>Par exemple, supposons que vous travaillez sur un projet et que vous souhaitez inclure les informations suivantes\u00a0:<\/p>\n<ul>\n<li>une courte description de ce que le PR fait pour que le mainteneur n&rsquo;ait pas \u00e0 deviner,<\/li>\n<li>le statut du PR indiquant s&rsquo;il doit \u00eatre pr\u00eat \u00e0 \u00eatre fusionn\u00e9 ou s&rsquo;il est encore en d\u00e9veloppement mais pr\u00eat pour une r\u00e9vision,<\/li>\n<li>un lien vers le ticket dans votre gestionnaire de projet auquel le PR est pertinent.<\/li>\n<\/ul>\n<p>Je ne dis pas que ce sont les informations requises, mais c&rsquo;est quelque chose que nous avons utilis\u00e9 et que j&rsquo;ai trouv\u00e9 utile (et c&rsquo;est bien de voir que d&rsquo;autres am\u00e9liorations sont apport\u00e9es <a href=\"https:\/\/help.github.com\/articles\/helping-people-contribute-to-your-project\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">au fil du temps<\/a> ).<\/p>\n<h3>Mais comment l&rsquo;utilisons-nous\u00a0?<\/h3>\n<p>Le site est assez clair, mais c&rsquo;est vraiment simple. Vous avez besoin des fichiers suivants dans votre r\u00e9pertoire de projet ou dans le dossier. <strong>r\u00e9pertoire github<\/strong>\u00a0:<\/p>\n<ul>\n<li><strong>ISSUE_TEMPLATE<\/strong><\/li>\n<li><strong>PULL_REQUEST_TEMPLATE<\/strong><\/li>\n<\/ul>\n<p>Chacun d&rsquo;entre eux devrait \u00eatre des fichiers de d\u00e9marquage qui expliquent exactement ce que vous recherchez pour vos contributeurs \u00e0 inclure chaque fois qu&rsquo;ils contribuent \u00e0 votre projet d&rsquo;une mani\u00e8re ou d&rsquo;une autre.<\/p>\n<p>Et puis, chaque fois qu&rsquo;un utilisateur cherche \u00e0 signaler un probl\u00e8me ou \u00e0 cr\u00e9er une demande d&rsquo;extraction, il re\u00e7oit les informations du mod\u00e8le.<\/p>\n<p>Nice, n&rsquo;est-ce pas?<\/p>\n<h2>Ce n&rsquo;est pas grand-chose, mais\u2026<\/h2>\n<p>Vous pensez peut-\u00eatre que ce n&rsquo;est pas grand-chose, mais il est assez facile d&rsquo;aider \u00e0 am\u00e9liorer la qualit\u00e9 des informations entrant dans un projet, de faire r\u00e9fl\u00e9chir vos contributeurs \u00e0 ce qu&rsquo;ils mettent dans le projet, puis de r\u00e9agir en cons\u00e9quence.<\/p>\n<p>De plus, cela vous aide, ainsi que le reste de votre \u00e9quipe, \u00e0 comprendre ce qui est sur le point d&rsquo;\u00eatre examin\u00e9 et \u00e0 vous pr\u00e9parer \u00e0 tout changement qui pourrait survenir lorsque vous travaillez sur ces projets.<\/p>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Source d&rsquo;enregistrement:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/tommcfarlin.com\" class=\"external external_icon\">tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Qu&rsquo;en est-il si le contenu du PR est li\u00e9 \u00e0 quelque chose dans Trello, Asana, Basecamp ou un autre syst\u00e8me ? C&rsquo;est l\u00e0 que les mod\u00e8les GitHub PR entrent en jeu.<\/p>\n","protected":false},"author":1,"featured_media":165951,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[717,1016,841],"tags":[1167],"class_list":["post-229722","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-developpeur","category-sites-utiles","category-tutoriels","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/229722","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=229722"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/229722\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/165951"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=229722"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=229722"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=229722"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}