Traitement d’une demande de tirage

Une fois que vous avez ouvert une demande de tirage (PR), la demande de tirage subit un ensemble de case activée et de révisions pour vous assurer que vos modifications proposées peuvent être fusionnées. Pour plus d’informations sur les demandes de tirage, consultez les notions de base de Git et GitHub.

Validation

Avant que votre demande de tirage puisse être fusionnée dans sa branche de destination, il peut être nécessaire de passer par un ou plusieurs processus de validation de demande de tirage. Une fois que vous avez sélectionné Créer une demande de tirage, GitHub exécute les validations configurées pour votre référentiel. Une fois le processus de validation terminé, les résultats apparaissent dans la demande de tirage.

Les processus de validation varient en fonction de l’étendue des modifications proposées et des règles du référentiel de destination. Une fois que vous avez envoyé votre demande de tirage, vous pouvez vous attendre à ce qu’une ou plusieurs des opérations suivantes se produisent :

• Fusion : un test de fusion GitHub de référence se produit d’abord pour vérifier si les modifications proposées dans votre branche sont en conflit avec la branche de destination. Si la demande de tirage indique que ce test a échoué, vous devez réconcilier le contenu qui provoque le ou les conflits de fusion pour que le traitement puisse continuer.
• Contrat de licence de contribution (CLA) : en tant que contributeur n’appartenant pas à Microsoft, si vous contribuez à un dépôt public, vous serez peut-être invité à remplir un court CLA la première fois que vous envoyez une demande de tirage à ce dépôt. Une fois cette étape terminée, votre demande de tirage sera traitée.
• Étiquetage : Les étiquettes sont automatiquement appliquées à votre demande de tirage pour indiquer l’état de votre demande de tirage pendant qu’elle passe par le flux de travail de validation. Par exemple, les nouvelles demandes de tirage peuvent recevoir automatiquement l’étiquette « ne pas fusionner », indiquant que la demande de tirage n’a pas encore terminé les étapes de validation, de révision et de déconnexion.
• Validation et génération : Des contrôles automatisés vérifient si vos modifications passent les tests de validation. Les tests de validation peuvent générer des avertissements ou des erreurs, ce qui vous oblige à apporter des modifications à un ou plusieurs fichiers de votre demande de tirage avant de pouvoir lancer la fusion. Les résultats des tests de validation sont ajoutés en tant que commentaire dans votre demande de tirage afin que vous puissiez les consulter, et ils peuvent également vous être envoyés par courrier électronique.
• Indexation : une fois la validation et la génération terminées, les articles que vous avez modifiés sont automatiquement déployés sur un environnement intermédiaire pour être examinés. Des URL de préversion apparaissent dans un commentaire de demande de tirage.
• Fusionner automatiquement: La demande de tirage peut être automatiquement fusionnée si elle réussit le test de validation et certains critères. Dans ce cas, vous n’avez pas besoin de faire autre chose.

Passer en revue et traiter les commentaires

Une fois que tout le traitement des demandes de tirage est terminé, vous devez passer en revue les résultats (par exemple, commentaires de demande de tirage, résultats de génération). Vous pouvez alors apporter d’autres modifications ou donner le feu vert pour la fusion. Vous devrez peut-être modifier votre contenu pour l’une des raisons suivantes :

• Commentaires de demande de tirage des réviseurs. Si un réviseur de demande de tirage a examiné votre demande de tirage, il peut fournir des commentaires par le biais de commentaires s’il existe des problèmes ou des questions en suspens à résoudre avant la fusion.
• Commentaires des réviseurs d’homologues.
• Corrections de mise en forme en raison de problèmes de rendu.
• Erreurs de validation ou avertissements.
• Conflits de fusion.

Si vous avez besoin d’apporter des modifications, vous pouvez modifier votre contenu directement dans la demande de tirage ou revenir à VS Code pour apporter vos modifications. Une fois que vous avez terminé, validez vos modifications dans votre branche de travail. La demande de tirage est automatiquement mise à jour avec vos modifications.

Chaque fois que vous ajoutez une validation à la même branche de travail, la validation est ajoutée automatiquement à la demande de tirage. Avec chaque validation, le système de publication réexécute automatiquement les processus de validation et de révision.

Déconnexion et automatisation des commentaires

Lorsque vous avez résolu toutes les erreurs de commentaires et de validation, et que vous êtes prêt à fusionner vos modifications, il est temps de vous déconnecter de votre demande de tirage en créant un commentaire qui lit #sign-off. Vous devez entrer le #sign-off commentaire pour fusionner vos modifications. Même si toutes les révisions et validations case activée s passent, vous êtes responsable de l’utilisation de ce commentaire pour indiquer aux réviseurs de demande de tirage et aux administrateurs de dépôt que vos modifications sont prêtes à être fusionnées.

Lorsque les réviseurs déterminent que votre demande de tirage est gratuite et signée, vos modifications sont fusionnées dans le branche par défaut et la demande de tirage est fermée.

L’automatisation des commentaires permet aux utilisateurs qui n’ont pas d’autorisations d’écriture dans un dépôt de terminer une action au niveau de l’écriture en affectant l’étiquette appropriée à une demande de tirage. Si vous travaillez sur un dépôt où l’automatisation des commentaires a été implémentée, utilisez les commentaires avec mot-dièse répertoriés dans le tableau suivant pour affecter des étiquettes, les modifier ou clôturer une demande de tirage. Les auteurs Microsoft seront également avertis par e-mail pour révision et déconnexion chaque fois que les modifications sont proposées à leurs articles.

Commentaire avec mot-dièse	Qu’est-ce que cela fait ?
#sign-off	Affecte automatiquement l’étiquette ready-to-merge (prêt pour fusion) pour permettre aux réviseurs du dépôt de savoir que la demande de tirage est prête pour la révision/fusion. Si vous n’êtes pas l’auteur répertorié et essayez de valider une demande de tirage publique à l’aide du commentaire #sign-off, la demande de tirage est mise à jour pour indiquer que seul l’auteur peut affecter cette étiquette.
#hold-off	Supprime l’étiquette prête à fusionner au cas où vous changez d’avis ou faites une erreur. Dans le dépôt privé, le libellé do-not-merge (ne pas fusionner) est affecté.
#please-close	Ferme la demande de tirage si vous décidez de ne pas fusionner les modifications.
#please-open	Rouvre une demande de tirage ou un problème fermé.

Publication

Votre demande de tirage doit être fusionnée par un réviseur de demande de tirage avant que les modifications puissent être incluses dans la prochaine exécution de publication planifiée. Normalement, les demandes de tirage sont examinées et fusionnées dans l’ordre d’envoi.

Une fois vos contributions approuvées et fusionnées, elles sont collectées par le processus de publication. Selon l’équipe qui gère le référentiel auquel vous contribuez, les heures de publication peuvent varier, mais elles se produisent généralement au moins une fois par semaine. Jusqu’à 45 minutes peuvent être nécessaires pour que les articles apparaissent en ligne après la publication.

Une fois vos modifications publiées, elles sont mises en ligne sur Microsoft Learn pour que d’autres commencent à apprendre à partir de !

Étapes suivantes

Et voilà ! Vous avez apporté une contribution au contenu de Microsoft Learn !