{"id":5090,"date":"2025-07-21T13:27:12","date_gmt":"2025-07-21T13:27:12","guid":{"rendered":"https:\/\/techhub.saworks.io\/docs\/tutoriel-github\/les-bases-de-github-partie-2-sur-2\/contribuer-a-un-depot-open-source\/"},"modified":"2025-07-31T12:46:21","modified_gmt":"2025-07-31T12:46:21","slug":"contribuer-a-un-depot-open-source","status":"publish","type":"docs","link":"https:\/\/techhub.saworks.io\/fr\/docs\/tutoriel-github\/les-bases-de-github-partie-2-sur-2\/contribuer-a-un-depot-open-source\/","title":{"rendered":"Contribuer \u00e0 un d\u00e9p\u00f4t open source"},"content":{"rendered":"\n
\n

Une fois que vous avez identifi\u00e9 un domaine dans lequel vous pouvez contribuer, l\u2019\u00e9tape suivante consiste \u00e0 pr\u00e9parer votre contribution. Nous allons revoir ici comment vous pouvez communiquer votre intention de participer \u00e0 un projet, cr\u00e9er une pull request<\/em>, et augmenter vos chances qu\u2019elle soit accept\u00e9e.<\/p>\n\n\n\n

Lorsqu\u2019il s\u2019agit de contribuer \u00e0 un projet open source, la communication est un facteur cl\u00e9 de r\u00e9ussite. Il se peut que vous soyez mal \u00e0 l\u2019aise \u00e0 l\u2019id\u00e9e de discuter avec d\u2019autres personnes \u00e0 propos des changements ou am\u00e9liorations que vous proposez. Souvent, ce dialogue m\u00e8nera \u00e0 des discussions et des compromis sur votre id\u00e9e initiale.<\/p>\n\n\n\n

\u00c9viter de communiquer activement avec les autres personnes impliqu\u00e9es dans un projet open source signifie que vous risquez de passer du temps \u00e0 travailler sur des t\u00e2ches que quelqu\u2019un d\u2019autre est d\u00e9j\u00e0 en train de faire. Ou bien, vous pourriez travailler sur des fonctionnalit\u00e9s ou des am\u00e9liorations qui ne sont pas en accord avec les valeurs ou les bonnes pratiques du projet. Dans les deux cas, le temps de chacun est perdu. \u00c0 l\u2019inverse, s\u2019engager dans une communication active garantit que votre travail sera bien accueilli et aura de l\u2019impact.<\/p>\n\n\n\n

Comment s\u2019assurer de r\u00e9ussir sa communication avec les membres d\u2019un projet \u00e0 propos de nouvelles fonctionnalit\u00e9s ou de changements ? Commencez par garder l\u2019esprit ouvert. Soyez r\u00e9ceptif aux retours et faites preuve de patience. Les mainteneurs de projets open source ont tr\u00e8s probablement un emploi \u00e0 temps plein et une vie priv\u00e9e \u00e0 g\u00e9rer. Si vous ne recevez pas de r\u00e9ponse imm\u00e9diatement, attendez un peu plus longtemps avant de relancer les mainteneurs.<\/p>\n\n\n\n

Communiquez votre intention aux mainteneurs<\/strong>
Vous devez toujours commencer par faire part de votre intention de contribuer avant de commencer \u00e0 travailler. Sauf indication contraire dans le fichier README, le issue tracker<\/em> est g\u00e9n\u00e9ralement l\u2019endroit id\u00e9al pour cela.<\/p>\n\n\n\n

Si vous souhaitez travailler sur un probl\u00e8me existant, v\u00e9rifiez que personne n\u2019y est d\u00e9j\u00e0 assign\u00e9 en consultant la section Assignees<\/strong>. V\u00e9rifiez \u00e9galement la section Linked pull requests<\/strong>. Une pull request<\/em> li\u00e9e signifie que quelqu\u2019un travaille d\u00e9j\u00e0 dessus. Parcourez les commentaires pour voir si quelqu\u2019un a exprim\u00e9 son int\u00e9r\u00eat pour ce probl\u00e8me. Si tout est clair, publiez un commentaire sur le probl\u00e8me pour indiquer votre intention de le prendre en charge. De cette fa\u00e7on, vous informez les autres personnes int\u00e9ress\u00e9es que quelqu\u2019un travaille d\u00e9j\u00e0 dessus. De plus, si n\u00e9cessaire, les mainteneurs peuvent vous r\u00e9pondre avec des conseils et des orientations.<\/p>\n\n\n\n

<\/div>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n

Contribuer \u00e0 une nouvelle fonctionnalit\u00e9 ou corriger un bug<\/strong><\/h3>\n\n\n\n

Si vous souhaitez travailler sur une nouvelle fonctionnalit\u00e9 ou sur un bug qui n\u2019est pas encore pr\u00e9sent dans le issue tracker<\/em>, cr\u00e9ez un nouveau ticket (issue<\/em>). Assurez-vous de suivre le mod\u00e8le propos\u00e9 s\u2019il y en a un, et exprimez clairement votre intention de travailler sur ce ticket. S\u2019il s\u2019agit d\u2019une proposition de nouvelle fonctionnalit\u00e9 ou si le probl\u00e8me n\u00e9cessite de nombreux changements, assurez-vous d\u2019obtenir l\u2019approbation des mainteneurs avant de passer \u00e0 l\u2019\u00e9tape suivante.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Cr\u00e9er une pull request sur un d\u00e9p\u00f4t GitHub<\/strong><\/h3>\n\n\n\n

Une fois que vous avez communiqu\u00e9 votre intention d\u2019aider le projet, vous \u00eates pr\u00eat \u00e0 commencer \u00e0 travailler sur votre contribution.<\/p>\n\n\n\n

Votre contribution prendra la forme d\u2019une pull request<\/em> (ou PR). Une pull request<\/em> est un espace sp\u00e9cial sur GitHub qui contient plusieurs \u00e9l\u00e9ments :<\/p>\n\n\n\n

    \n
  • Un titre et une description de vos modifications.<\/li>\n\n\n\n
  • Un ou plusieurs commits<\/em> qui constituent les changements que vous proposez.<\/li>\n\n\n\n
  • Des commentaires, o\u00f9 tout le monde peut participer \u00e0 une discussion sur les modifications.<\/li>\n\n\n\n
  • Des revues de code, o\u00f9 vous pouvez recevoir des retours d\u00e9taill\u00e9s sur vos changements et \u00e9ventuellement des suggestions de modifications.<\/li>\n\n\n\n
  • Des v\u00e9rifications de statut, par exemple issues de tests automatis\u00e9s mis en place par les mainteneurs. Ces v\u00e9rifications peuvent avoir diff\u00e9rents objectifs : s\u2019assurer que vos modifications respectent les r\u00e8gles du projet ou qu\u2019elles ne cassent pas le code existant.<\/li>\n<\/ul>\n\n\n\n

    Une fois la pull request<\/em> cr\u00e9\u00e9e, elle peut \u00eatre mise \u00e0 jour avec de nouveaux commits<\/em>, commentaires ou revues de code. Ce processus se poursuit jusqu\u2019\u00e0 ce que les mainteneurs du projet approuvent et fusionnent la pull request<\/em>, ou rejettent les modifications et la ferment. Lorsque votre pull request<\/em> est fusionn\u00e9e, cela signifie que vos modifications ont \u00e9t\u00e9 int\u00e9gr\u00e9es dans le code du projet.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    Cr\u00e9er une pull request \u00e9tape par \u00e9tape<\/strong><\/h3>\n\n\n\n
      \n
    1. Ouvrez la page GitHub du projet auquel vous souhaitez contribuer.<\/li>\n\n\n\n
    2. Cliquez sur le bouton Fork<\/strong> pour cr\u00e9er une copie du d\u00e9p\u00f4t sur votre compte GitHub. Cette \u00e9tape est n\u00e9cessaire car, par d\u00e9faut, vous n\u2019avez pas les permissions pour modifier un d\u00e9p\u00f4t public, sauf s\u2019il s\u2019agit de votre propre copie. En forkant<\/em> le projet, vous cr\u00e9ez une copie sur laquelle vous pouvez effectuer des modifications.<\/li>\n<\/ol>\n\n\n\n
      <\/div>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      <\/div>\n\n\n\n

      3. S\u00e9lectionnez Vos r\u00e9f\u00e9rentiels<\/strong> dans le menu profil de votre compte.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n
      <\/div>\n\n\n\n

      4. S\u00e9lectionnez le fork du d\u00e9p\u00f4t.<\/strong><\/p>\n\n\n\n

      5. Cliquez sur le bouton Code<\/strong> pour obtenir des informations sur la fa\u00e7on de cloner<\/em> le d\u00e9p\u00f4t Git sur votre machine locale.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n
      <\/div>\n\n\n\n

      6. S\u00e9lectionnez l\u2019ic\u00f4ne du Presse-papiers<\/strong> pour copier l\u2019URL du d\u00e9p\u00f4t, puis entrez ceci dans un terminal :<\/p>\n\n\n\n

      <\/div>\n\n\n\n
      <\/circle><\/circle><\/circle><\/g><\/svg><\/span>