Propositions de fusion
Demandez la révision des modifications d’une branche avant leur fusion dans une autre branche.
Vue d’ensemble
Une proposition de fusion enregistre une demande de fusion des modifications d’une branche dans une autre et permet à un collègue d’examiner le diff avant la fusion. Toute personne disposant d’un accès de modification à l’agent peut ouvrir une proposition, y compris vers une branche qu’elle ne peut pas elle-même fusionner. La fusion de la proposition nécessite toujours un accès en écriture à la branche cible. Une proposition permet donc d’intégrer une modification dans une branche protégée sans accorder à chaque contributeur des droits de fusion sur celle-ci.
Les propositions de fusion ajoutent une étape de révision facultative à la fusion directe de branches. Fusionnez directement lorsque vous disposez d’un accès en écriture à la branche cible et n’avez pas besoin d’un second avis. Ouvrez une proposition lorsque vous souhaitez une révision préalable ou lorsque la branche cible est protégée et que vous n’y avez pas accès en écriture.
Disponibilité
Les propositions de fusion sont en alpha. Lorsque plusieurs branches d’un agent sont en cours simultanément, il devient difficile de savoir lesquelles sont prêtes et peuvent être fusionnées sans risque. Les propositions de fusion offrent à une équipe un espace unique pour examiner et discuter des modifications d’une branche, comparer les taux de réussite des tests entre branches et consulter les conversations les plus récentes de la branche.
L’alpha constitue une première étape vers un workflow de type CI/CD pour les agents, similaire aux pull requests sur GitHub. Des ajouts sont prévus dans les prochaines semaines :
- Des tests obligatoires devant réussir avant la fusion d’une proposition.
- La demande d’approbations à des réviseurs spécifiques.
- La configuration de responsables pour différentes parties d’un agent.
Cycle de vie d’une proposition
Chaque proposition présente l’un des statuts suivants :
Lorsqu’une proposition est ouverte, les réviseurs peuvent rendre l’un des avis suivants. Le dernier avis d’un réviseur remplace tout avis précédent de ce même réviseur :
Ouvrir une proposition
Ouvrez une proposition depuis la branche dont vous souhaitez faire réviser les modifications :
Depuis la liste des branches
Depuis l’onglet Proposals
Dans l’onglet Branches de l’agent, ouvrez le menu d’options de la branche source et sélectionnez **Open merge proposal **.
Donnez un titre à la proposition, ajoutez une description facultative et choisissez une branche cible parmi les autres branches non archivées de l’agent. L’ouverture d’une proposition ne modifie aucune des deux branches, elle enregistre uniquement la demande.
Une paire de branches source et cible ne peut avoir qu’une seule proposition ouverte à la fois. Fermez celle qui existe avant d’en ouvrir une autre entre les mêmes deux branches.
Réviser une proposition
La page d’une proposition comporte les onglets suivants :
Vue d’ensemble
Modifications
Exécutions de tests
Conversations
La description, l’historique des révisions et un formulaire pour laisser une révision.
Toute personne disposant d’un accès de modification à l’agent, à l’exception de l’auteur de la proposition, peut laisser une révision avec un commentaire facultatif. Les commentaires prennent en charge Markdown.
Fusionner une proposition
La fusion d’une proposition effectue la même fusion de branches qu’une fusion directe, y compris la résolution des conflits et l’option d’archiver ensuite la branche source. Avant de pouvoir être fusionnée, une proposition doit satisfaire aux exigences suivantes :
- L’utilisateur qui effectue la fusion dispose d’un accès en écriture aux branches source et cible. Pour une branche protégée, cela implique d’être administrateur du Workspace.
- Le dernier avis d’aucun réviseur n’est « modifications demandées ». Un réviseur ayant demandé des modifications doit approuver avant que la proposition puisse être fusionnée.
- La proposition compte au moins une approbation d’une personne autre que son auteur. Les administrateurs du Workspace peuvent fusionner sans cette approbation.
La fusion d’une proposition ferme automatiquement toute autre proposition ouverte pour la même branche source, puisque ses modifications ont désormais été intégrées.
Fermer une proposition
Une proposition peut être fermée sans être fusionnée à tout moment tant qu’elle est ouverte. L’auteur et les réviseurs peuvent modifier son titre et sa description jusqu’à sa fermeture.
- Lorsque l’auteur ferme sa propre proposition, elle est enregistrée comme retirée.
- Lorsqu’une autre personne la ferme, elle est enregistrée comme rejetée.
- L’archivage de la branche source ferme automatiquement toute proposition ouverte depuis ou vers celle-ci, enregistrée comme branch_archived.
Propositions de fusion et ElevenAgents Architect
Architect peut ouvrir des propositions de fusion pour vous. Après avoir apporté et testé une modification sur une branche, il lit les commits de la branche et l’aperçu de la fusion, puis ouvre une proposition comprenant les sections Résumé, Tests et Comment réviser. Il peut également suggérer des réviseurs parmi lesquels vous pourrez choisir. Comme Architect agit en votre nom, la proposition vous désigne comme auteur.
Architect ne peut pas réviser, approuver, fusionner ni fermer une proposition. Ces étapes sont toujours effectuées par des personnes. Consultez Propositions et validation pour le workflow complet.