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 ».
Conseil : 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
-
Collectez le nom et l’adresse e-mail de chaque co-auteur. Si une personne choisit de garder son adresse e-mail privée, vous devez utiliser son e-mail
no-reply
fourni par GitHub pour protéger sa confidentialité. -
Entrez votre message de validation ainsi qu’une description courte et explicite de vos modifications. Après votre description de validation, plutôt qu’un guillemet fermant, ajoutez deux lignes vides.
$ git commit -m "Refactor usability tests. > >
Conseil : si vous utilisez un éditeur de texte sur la ligne de commande pour entrer votre message de validation, vérifiez qu’il existe bien deux nouvelles lignes entre la fin de votre description de validation et le code de fin de la validation
Co-authored-by:
. -
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.
- Collectez le nom et l’adresse e-mail de chaque co-auteur. Si une personne choisit de garder son adresse e-mail privée, vous devez utiliser son e-mail
no-reply
fourni par GitHub pour protéger sa confidentialité. - Cliquez sur Commiter les changements.
- Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée.
- 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 validationCo-authored-by:
. - 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
- « Affichage des contributeurs d’un projet »
- « Changement d’un message de commit »
- « Commit et revue des changements apportés à votre projet dans GitHub Desktop » dans la documentation GitHub Desktop