Mergevoorstellen
Overzicht
Een mergevoorstel legt een verzoek vast om de wijzigingen van de ene branch in een andere samen te voegen en laat een teamgenoot de diff beoordelen voordat dat gebeurt. Iedereen met bewerkingstoegang tot de agent kan een voorstel openen, zelfs voor een branch waarin die persoon zelf niet kan mergen. Voor het mergen van het voorstel is nog steeds schrijftoegang tot de doelbranch vereist. Via een voorstel kan een wijziging dus een beschermde branch bereiken zonder elke bijdrager mergerrechten voor die branch te geven.
Mergevoorstellen voegen een optionele beoordelingsstap toe boven op het rechtstreeks mergen van branches. Merge rechtstreeks wanneer je schrijftoegang tot de doelbranch hebt en geen tweede mening nodig hebt. Open een voorstel wanneer je eerst een beoordeling wilt, of wanneer de doelbranch beschermd is en je er geen schrijftoegang toe hebt.
Beschikbaarheid
Mergevoorstellen bevinden zich in alpha. Wanneer meerdere branches van een agent tegelijk in ontwikkeling zijn, wordt het lastig om bij te houden welke klaar zijn en veilig kunnen worden gemerged. Mergevoorstellen geven een team één plek om de wijzigingen van een branch te beoordelen en te bespreken, slagingspercentages van tests tussen branches te vergelijken en de meest recente gesprekken van de branch te bekijken.
De alpha is een eerste stap naar een CI/CD-workflow voor agents, vergelijkbaar met pull requests op GitHub. Geplande toevoegingen in de komende weken zijn:
- Verplichte tests die moeten slagen voordat een voorstel kan worden gemerged.
- Goedkeuringen aanvragen bij specifieke reviewers.
- Eigenaren configureren voor verschillende onderdelen van een agent.
Levenscyclus van een voorstel
Elk voorstel heeft een van deze statussen:
Zolang een voorstel open is, kunnen reviewers een van deze beoordelingen achterlaten. De meest recente beoordeling van een reviewer vervangt een eerdere beoordeling van dezelfde reviewer:
Een voorstel openen
Open een voorstel vanuit de branch waarvan je de wijzigingen wilt laten beoordelen:
Vanuit de branchlijst
Vanaf het tabblad Proposals
Open op het tabblad Branches van de agent het optiemenu van de bronbranch en selecteer **Open merge proposal **.
Geef het voorstel een titel, een optionele beschrijving en kies een doelbranch uit de andere niet-gearchiveerde branches van de agent. Het openen van een voorstel wijzigt geen van beide branches; het registreert alleen het verzoek.
Een paar van bron- en doelbranch kan maximaal één open voorstel tegelijk hebben. Sluit het bestaande voorstel voordat je een nieuw voorstel opent tussen dezelfde twee branches.
Een voorstel beoordelen
De pagina van een voorstel heeft deze tabbladen:
Overzicht
Wijzigingen
Testuitvoeringen
Gesprekken
De beschrijving, beoordelingsgeschiedenis en een formulier om een beoordeling achter te laten.
Iedereen met bewerkingstoegang tot de agent, behalve de auteur van het voorstel zelf, kan een beoordeling met een optionele opmerking achterlaten. Opmerkingen ondersteunen markdown.
Een voorstel mergen
Het mergen van een voorstel voert dezelfde branchmerge uit als rechtstreeks mergen, inclusief conflictoplossing en de optie om daarna de bronbranch te archiveren. Voordat een voorstel kan worden gemerged, moet het aan deze vereisten voldoen:
- De gebruiker die mergt heeft schrijftoegang tot zowel de bron- als de doelbranch. Voor een beschermde branch betekent dat dat deze gebruiker workspacebeheerder moet zijn.
- De meest recente beoordeling van geen enkele reviewer is “changes requested”. Een reviewer die wijzigingen heeft aangevraagd, moet goedkeuren voordat het voorstel kan worden gemerged.
- Het voorstel heeft minstens één goedkeuring van iemand anders dan de auteur. Workspacebeheerders kunnen mergen zonder deze goedkeuring.
Door een voorstel te mergen, worden alle andere open voorstellen voor dezelfde bronbranch automatisch gesloten, omdat de wijzigingen nu zijn doorgegaan.
Een voorstel sluiten
Een voorstel kan op elk moment worden gesloten zonder te mergen zolang het open is. De auteur en reviewers kunnen de titel en beschrijving wijzigen totdat het gesloten is.
- Wanneer de auteur het eigen voorstel sluit, wordt het geregistreerd als ingetrokken.
- Wanneer iemand anders het sluit, wordt het geregistreerd als afgewezen.
- Door de bronbranch te archiveren, wordt elk open voorstel van of naar die branch automatisch gesloten en geregistreerd als branch_archived.
Mergevoorstellen en ElevenAgents Architect
Architect kan mergevoorstellen voor je openen. Nadat Architect een wijziging op een branch heeft gemaakt en getest, leest het de commits en mergevoorvertoning van de branch en opent het een voorstel met de secties Samenvatting, Testen en Beoordelen. Het kan ook reviewers voorstellen waaruit je kunt kiezen. Omdat Architect namens jou handelt, vermeldt het voorstel jou als auteur.
Architect kan een voorstel niet beoordelen, goedkeuren, mergen of sluiten. Die stappen worden altijd door mensen uitgevoerd. Bekijk Voorstellen en validatie voor de volledige flow.