Bearbeta en pull-begäran

När du har öppnat en pull-begäran (PR) genomgår PR en uppsättning kontroller och granskningar för att säkerställa att de föreslagna ändringarna kan sammanfogas. Mer bakgrund om PR finns i Grunderna för Git och GitHub.

Verifiering

Innan din pr kan sammanfogas till målgrenen kan det krävas att du passerar en eller flera PR-valideringsprocesser. När du har valt Skapa pull-begäran kör GitHub valideringarna som konfigurerats för lagringsplatsen. När valideringsprocessen är klar visas resultatet i PR.

Valideringsprocesserna varierar beroende på omfattningen av föreslagna ändringar och reglerna för mållagringsplatsen. När du har skickat in din pr kan du förvänta dig att ett eller flera av följande händer:

• Sammanslagningsbarhet: Ett github-baslinjetest för sammanfogning sker först för att kontrollera om de föreslagna ändringarna i din gren är i konflikt med målgrenen. Om PR anger att det här testet misslyckades måste du stämma av innehållet som orsakar sammanslagningskonflikten innan bearbetningen kan fortsätta.
• Licensavtal för bidrag (CLA): Om du bidrar till en offentlig lagringsplats kan du bli ombedd att slutföra ett kort CLA första gången du skickar en PR till den lagringsplatsen. När CLA-steget har rensats bearbetas din pr.
• Etikettering: Etiketter tillämpas automatiskt på din pr för att ange status för din pr när den passerar genom valideringsarbetsflödet. Till exempel kan nya PR:er automatiskt få etiketten "do-not-merge", vilket indikerar att PR ännu inte har slutfört verifierings-, gransknings- och signeringsstegen.
• Validering och version: Kontrollerar automatiskt om ändringarna godkänns i valideringstesterna. Valideringstesterna kan ge varningar eller fel, vilket kräver att du redigerar en eller flera filer i din PR innan den kan sammanfogas. Valideringstestresultatet läggs till som en kommentar i din PR för din granskning och de kan skickas till dig via e-post.
• Mellanlagring: När valideringen och bygget lyckas distribueras de artiklar som du ändrade automatiskt till en mellanlagringsmiljö för granskning. Granska URL:erna som visas i pull-begärans kommentar.
• Automatisk sammanslagning: Pr kan sammanfogas automatiskt om den klarar valideringstestning och vissa kriterier. I det här fallet behöver du inte göra något annat.

Granska och åtgärda feedback

När all PR-bearbetning är klar bör du granska resultaten (till exempel PR-kommentarer, byggresultat). Ta reda på om du behöver göra fler ändringar innan du loggar ut för sammanslagning. Du kan behöva ändra ditt innehåll av någon av följande orsaker:

• PR-kommentarer från granskare. Om en PR-granskare har granskat din pr kan de ge feedback via kommentarer om det finns kvarstående problem eller frågor som ska lösas före sammanslagning.
• Feedback från peer-granskare.
• Formateringskorrigeringar på grund av återgivningsproblem.
• Valideringsfel eller varningar.
• Sammanslagningskonflikter.

Om du behöver göra ändringar kan du redigera ditt innehåll direkt i PR eller gå tillbaka till VS Code för att göra dina ändringar. När du är klar checkar du in ändringarna i arbetsgrenen. Pr uppdateras automatiskt med dina ändringar.

Varje gång du lägger till en incheckning i samma arbetsgren läggs incheckningen automatiskt till i PR. Med varje incheckning kör publiceringssystemet validerings- och granskningsprocesserna automatiskt igen.

Automatisering av signering och kommentarer

När du har åtgärdat alla feedback- och valideringsfel och du är redo för att dina ändringar ska sammanfogas är det dags att logga ut på din PR genom att skapa en ny kommentar med texten #sign-off. Du måste ange kommentaren #sign-off för att sammanfoga ändringarna. Även om alla granskningar och valideringskontroller godkänns ansvarar du för att använda den här kommentaren för att berätta för PR-granskare och lagringsplatsadministratörer att dina ändringar är redo för sammanslagning.

När granskarna fastställer att din pr är problemfri och signerad sammanfogas dina ändringar till standardgrenen och PR stängs.

Med kommentarsautomatisering kan användare som inte har skrivbehörighet i en lagringsplats slutföra en åtgärd på skrivnivå genom att tilldela lämplig etikett till en PR. Om du arbetar på en lagringsplats där kommentarsautomation har implementerats använder du hashtaggkommentarna som anges i följande tabell för att tilldela etiketter, ändra etiketter eller stänga en PR. Microsoft-författare kommer också att meddelas via e-post för granskning och signering när ändringar föreslås i deras artiklar.

Hashtaggkommentar	Vad den gör
#sign-off	Tilldelar automatiskt etiketten ready-to-merge för att låta granskarna på lagringsplatsen veta att PR:en är redo för granskning/sammanslagning. Om du inte är den listade författaren och försöker logga ut på en offentlig lagringsplats-PR med hjälp av kommentaren #sign-off uppdateras PR för att indikera att endast författaren kan tilldela etiketten.
#hold-off	Tar bort etiketten ready-to-merge om du ändrar dig eller gör ett misstag. I en privat lagringsplats tilldelas etiketten do-not-merge (slå inte samman).
#please-close	Stänger PR om du bestämmer dig för att inte koppla ändringarna.
#please-open	Öppnar en stängd pr eller ett problem igen.

Publicera

Din pr måste sammanfogas av en PR-granskare innan ändringarna kan inkluderas i nästa schemalagda publiceringskörning. Normalt granskas och sammanfogas PR:er i inlämningsordningen.

När dina bidrag har godkänts och slagits samman hämtar publiceringsprocessen dem. Beroende på vilket team som hanterar lagringsplatsen som du bidrar till kan publiceringstiderna variera, men de inträffar vanligtvis minst en gång varje veckodag. Det kan ta upp till 45 minuter innan artiklar syns online efter publicering.

När dina ändringar har publicerats går de live på Microsoft Learn så att andra kan börja lära sig från!

Nästa steg

Det var allt! Du har bidragit till Microsoft Learn-innehåll!