Comment contribuer

Nous serions ravis d'accepter vos correctifs et vos contributions à ce projet. Il y a seulement quelques petites directives que vous devez suivre.

Contrat de licence Contributeur

Les contributions à un projet Google doivent être accompagnées d'un Contrat de licence Contributeur. Il ne s'agit pas d'une attribution de droits d'auteur. Cela permet simplement à Google d'utiliser et de redistribuer vos contributions dans le cadre du projet.

Généralement, vous n'avez besoin de le faire qu'une seule fois. Par conséquent, si vous en avez déjà soumis un (même si c'était pour un autre projet), vous n'avez probablement pas besoin de le faire à nouveau.

Envoi d'un correctif

  1. Il est généralement préférable de commencer par ouvrir un nouveau problème décrivant le bug ou la fonctionnalité que vous souhaitez résoudre. Même si vous pensez qu'il s'agit d'une tâche relativement mineure, il est utile de savoir sur quoi les collaborateurs travaillent. Mentionnez dans le problème initial que vous prévoyez de travailler sur ce bug ou cette fonctionnalité afin qu'il puisse vous être attribué.

  2. Suivez le processus normal de duplication du projet et configurez une nouvelle branche dans laquelle travailler. Il est important que chaque groupe de modifications soit effectué dans des branches distinctes afin de garantir qu'une demande d'extraction n'inclut que les commits liés à ce bug ou cette fonctionnalité.

  3. Toute modification importante doit presque toujours être accompagnée de tests. Le projet dispose déjà d'une bonne couverture de test. Si vous ne savez pas comment procéder, consultez certains des tests existants.

  4. Faites de votre mieux pour disposer de messages de commit correctement formatés pour chaque modification. Cela assure la cohérence tout au long du projet et garantit que les messages de commit peuvent être correctement formatés par divers outils Git.

  5. Enfin, transférez les commits dans votre copie et envoyez une requête pull.