Een pull-aanvraag verwerken

Nadat u een pull-aanvraag (PR) hebt geopend, ondergaat de pull-aanvraag een set controles en beoordelingen om ervoor te zorgen dat uw voorgestelde wijzigingen kunnen worden samengevoegd. Zie de basisprincipes van Git en GitHub voor meer achtergrondinformatie over PULL's.

Validatie

Voordat uw pull-aanvraag kan worden samengevoegd in de doelvertakking, moet u mogelijk een of meer pr-validatieprocessen doorlopen. Nadat u Pull-aanvraag maken hebt geselecteerd, worden in GitHub de validaties uitgevoerd die zijn geconfigureerd voor uw opslagplaats. Wanneer het validatieproces is voltooid, worden de resultaten weergegeven in de pull-aanvraag.

Validatieprocessen variëren afhankelijk van het bereik van voorgestelde wijzigingen en de regels van de doelopslagplaats. Nadat u uw pull-aanvraag hebt ingediend, kunt u een of meer van de volgende dingen verwachten:

• Samenvoegbaarheid: Er wordt eerst een GitHub-samenvoegbaarheidstest volgens de basislijn uitgevoerd om te controleren of de voorgestelde wijzigingen in uw vertakking conflicteren met de doelvertakking. Als de pull-aanvraag aangeeft dat deze test is mislukt, moet u de inhoud afstemmen die het samenvoegingsconflict veroorzaakt voordat de verwerking kan worden voortgezet.
• Bijdragelicentieovereenkomst (CLA): als niet-Microsoft-inzender wordt u mogelijk gevraagd om een korte CLA te voltooien wanneer u voor het eerst een pull-aanvraag indient bij die opslagplaats. Nadat de CLA-stap is gewist, wordt uw pull-aanvraag verwerkt.
• Labelen: labels worden automatisch toegepast op uw pull-aanvraag om de status van uw pull-aanvraag aan te geven terwijl deze de validatiewerkstroom doorloopt. Nieuwe pull-aanvragen kunnen bijvoorbeeld automatisch het label 'do not-merge' ontvangen, waarmee wordt aangegeven dat de pull-aanvraag de stappen voor validatie, controle en afmelding nog niet heeft voltooid.
• Validatie en build: Uw wijzigingen worden door geautomatiseerde controles onderzocht om te controleren of ze de validatietests doorstaan. De validatietests kunnen waarschuwingen of fouten opleveren, waarbij u een of meer bestanden in uw pull-aanvraag moet bewerken voordat deze kan worden samengevoegd. De resultaten van de validatietest worden toegevoegd als opmerking in uw pull-aanvraag voor uw beoordeling en ze worden mogelijk per e-mail naar u verzonden.
• Fasering: Na een geslaagde validatie en build worden de artikelen die u hebt gewijzigd, automatisch geïmplementeerd in een faseringsomgeving voor revisie. Voorbeeld-URL’s worden in een pull-aanvraagopmerking weergegeven.
• Automatisch samenvoegen: de pull-aanvraag kan automatisch worden samengevoegd als deze voldoet aan validatietests en bepaalde criteria. In dit geval hoeft u niets anders te doen.

Feedback beoordelen en adressen

Nadat alle pr-verwerking is voltooid, moet u de resultaten bekijken (bijvoorbeeld PR-opmerkingen, buildresultaten). Bepaal of u meer wijzigingen moet aanbrengen voordat u zich afmeldt voor samenvoegen. Mogelijk moet u uw inhoud om een van de volgende redenen wijzigen:

• PR-opmerkingen van revisoren. Als een revisor van pull-aanvragen uw pull-aanvraag heeft beoordeeld, kan deze feedback geven via opmerkingen als er openstaande problemen of vragen zijn die moeten worden opgelost voordat u deze samenvoegt.
• Feedback van collega-revisoren.
• Opmaakoplossingen vanwege renderingproblemen.
• Validatiefouten of waarschuwingen.
• Samenvoegingsconflicten.

Als u wijzigingen wilt aanbrengen, kunt u uw inhoud rechtstreeks in de pull-aanvraag bewerken of terugkeren naar VS Code om uw wijzigingen aan te brengen. Wanneer u klaar bent, moet u uw wijzigingen doorvoeren in uw werkvertakking. De pull-aanvraag wordt automatisch bijgewerkt met uw wijzigingen.

Telkens wanneer u een doorvoering aan dezelfde werkbranch toevoegt, wordt de doorvoer automatisch toegevoegd aan de pull-aanvraag. Bij elke doorvoering voert het publicatiesysteem de validatie- en beoordelingsprocessen automatisch opnieuw uit.

Automatisering van afmelden en opmerkingen toevoegen

Wanneer u alle feedback- en validatiefouten hebt opgelost en u klaar bent om uw wijzigingen samen te voegen, is het tijd om u af te melden bij uw pull-aanvraag door een nieuwe opmerking te maken die wordt gelezen #sign-off. U moet de #sign-off opmerking invoeren om uw wijzigingen samen te voegen. Zelfs als alle beoordelingen en validatiecontroles zijn geslaagd, bent u verantwoordelijk voor het gebruik van deze opmerking om de revisoren van pull-aanvragen en opslagplaatsbeheerders te laten weten dat uw wijzigingen gereed zijn voor samenvoegen.

Wanneer de revisoren bepalen dat uw pull-aanvraag probleemloos is en is afgemeld, worden uw wijzigingen samengevoegd in de standaardvertakking en wordt de pull-aanvraag gesloten.

Met automatisering van opmerkingen kunnen gebruikers die geen schrijfmachtigingen hebben in een opslagplaats een actie op schrijfniveau voltooien door het juiste label toe te wijzen aan een pull-aanvraag. Als u in een opslagplaats werkt waarin automatisering van opmerkingen is geïmplementeerd, gebruikt u de hashtagopmerkingen in de volgende tabel om labels toe te wijzen, labels te wijzigen of een pull-aanvraag te sluiten. Microsoft-auteurs worden ook per e-mail op de hoogte gesteld voor beoordeling en afmelding wanneer wijzigingen worden voorgesteld in hun artikelen.

Hashtag-opmerking	Functie
#sign-off	Wijst automatisch het label gereed voor samenvoeging toe om de revisoren in de opslagplaats te laten weten dat de pull-aanvraag gereed is voor beoordeling/samenvoegen. Als u niet de vermelde auteur bent en probeert u zich af te melden bij een openbare opslagplaats met behulp van de opmerking, wordt de #sign-off pull-aanvraag bijgewerkt om aan te geven dat alleen de auteur het label kan toewijzen.
#hold-off	Hiermee verwijdert u het kant-en-klare label voor het geval u van gedachten verandert of een fout maakt. In de persoonlijke opslagplaats wordt hierdoor het label do-not-merge toegewezen.
#please-close	Hiermee sluit u de pull-aanvraag als u besluit de wijzigingen niet samen te voegen.
#please-open	Opent een gesloten pull-aanvraag of een gesloten probleem opnieuw.

Publiceren

Uw pull-aanvraag moet worden samengevoegd door een revisor voor pull-aanvragen voordat de wijzigingen kunnen worden opgenomen in de volgende geplande publicatieuitvoering. Normaal gesproken worden pull-aanvragen beoordeeld en samengevoegd in de volgorde van indiening.

Nadat uw bijdragen zijn goedgekeurd en samengevoegd, worden deze door het publicatieproces opgehaald. Afhankelijk van het team dat de opslagplaats beheert waaraan u een bijdrage levert, kunnen de publicatietijden variëren, maar meestal ten minste één keer per weekdag. Het kan tot 45 minuten duren voordat artikelen online verschijnen nadat ze zijn gepubliceerd.

Zodra uw wijzigingen zijn gepubliceerd, gaan ze live naar Microsoft Learn, zodat anderen kunnen beginnen met leren.

Volgende stappen

Dat is het! U hebt een bijdrage geleverd aan Microsoft Learn-inhoud.