Création d’une validation avec plusieurs auteurs

Vous pouvez attribuer un commit à plusieurs auteurs en ajoutant un ou plusieurs codes de fin Co-authored-by au message du commit. Les commits co-créés sont visibles sur GitHub.

Dans cet article

Informations de co-auteur requises

Avant d’ajouter un co-auteur à une validation, vous devez connaître l’adresse e-mail à utiliser pour chaque co-auteur. Pour que le commit du co-auteur soit pris en compte en tant que contribution, vous devez utiliser l'adresse e-mail associée à son compte sur GitHub.com.

Si une personne choisit de ne pas divulguer son adresse e-mail, vous devez utiliser l'adresse no-reply fournie par GitHub pour protéger sa vie privée. Sinon, l'adresse e-mail du co-auteur sera disponible au public dans le message de validation. Si vous ne souhaitez pas divulguer votre adresse e-mail, vous pouvez choisir d’utiliser une adresse e-mail no-reply fournie par GitHub pour les opérations Git et demander à d’autres co-auteurs de répertorier votre adresse e-mail no-reply dans les codes de fin de validation.

Pour plus d’informations, consultez « Définition de votre adresse e-mail de commit ».

Tip

Vous pouvez aider un co-auteur à trouver son adresse e-mail préférée en partageant ces informations :

  • Pour trouver votre adresse no-reply fournie par GitHub, accédez à votre page de paramètres de messagerie sous « Laisser mon adresse e-mail privée ».
  • Pour trouver l’adresse e-mail utilisée pour configurer Git sur votre ordinateur, exécutez-git config user.email sur la ligne de commande.

Création de validations co-créées à l’aide de GitHub Desktop

Vous pouvez utiliser GitHub Desktop pour créer une validation avec un co-auteur. Pour plus d’informations, consultez Commit et revue des changements apportés à votre projet dans GitHub Desktop et GitHub Desktop.

Création de validations co-créées sur la ligne de commande

  1. Recueillez le nom et l'adresse électronique de chaque co-auteur. Si une personne choisit de garder son adresse électronique privée, vous devez utiliser les GitHub fournies par no-reply email pour protéger leur vie privée.

  2. Entrez votre message de validation ainsi qu’une description courte et explicite de vos modifications. Après votre description de commit, plutôt qu’un guillemet fermant, ajoutez une ligne vide.

    $ git commit -m "Refactor usability tests.
>
>

    Tip

    Si vous utilisez un éditeur de texte en ligne de commande pour taper votre message de commit, assurez-vous qu’il y a une ligne vide (deux sauts de ligne consécutifs) entre la fin de votre description de commit et le code de fin de votre commit Co-authored-by:.

  3. Sur la ligne suivante du message de validation, entrez Co-authored-by: name <name@example.com> avec les informations spécifiques pour chaque co-auteur. Après les informations de co-auteur, ajoutez un guillemet fermant.

    Si vous ajoutez plusieurs co-auteurs, donnez à chacun sa propre ligne et son propre code de fin de validation Co-authored-by:. N’ajoutez pas de lignes vides entre chaque ligne de co-auteur.

    $ git commit -m "Refactor usability tests.
>
> Co-authored-by: NAME <NAME@EXAMPLE.COM>
> Co-authored-by: ANOTHER-NAME <ANOTHER-NAME@EXAMPLE.COM>"

Le nouveau commit et le nouveau message apparaîtront dans GitHub.com lors de votre prochain push. Pour plus d’informations, consultez « Poussée de commits vers un dépôt distant ».

Création de validations co-créées sur GitHub

Après avoir apporté des modifications à un fichier à l’aide de l’éditeur web sur GitHub, vous pouvez créer une validation co-créée en ajoutant un code de fin Co-authored-by: au message de la validation.

  1. Recueillez le nom et l'adresse électronique de chaque co-auteur. Si une personne choisit de garder son adresse électronique privée, vous devez utiliser les GitHub fournies par no-reply email pour protéger leur vie privée.
  2. Cliquez sur Commiter les changements.
  3. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée.
  4. Dans la zone de texte située sous votre message de validation, ajoutez Co-authored-by: name <name@example.com> avec les informations spécifiques pour chaque co-auteur. Si vous ajoutez plusieurs co-auteurs, donnez à chacun sa propre ligne et son propre code de fin de validation Co-authored-by:.
  5. Cliquez sur Valider les modifications ou Proposer des modifications.

Le nouveau commit et le nouveau message apparaîtront dans GitHub.com.

Pour aller plus loin