Behandl en pullanmodning
Når du har åbnet en pullanmodning, gennemgår pullanmodningen et sæt kontroller og korrekturer for at sikre, at dine foreslåede ændringer kan flettes. Du kan få mere at vide om pullanmodninger under Grundlæggende oplysninger om Git og GitHub.
Validering
Før din pullanmodning kan flettes til destinationsforgreningen, kan det være nødvendigt at gennemgå en eller flere processer til validering af pullanmodninger. Når du har valgt Opret pullanmodning, kører GitHub de valideringer, der er konfigureret for dit lager. Når valideringsprocessen er afsluttet, vises resultaterne i pullanmodningen.
Valideringsprocesserne varierer afhængigt af omfanget af foreslåede ændringer og reglerne for destinationslageret. Når du har indsendt din pullanmodning, kan du forvente, at et eller flere af følgende sker:
- Fletbarhed: Der udføres først en grundlæggende GitHub-test for at kontrollere, om de foreslåede ændringer i din forgrening er i konflikt med destinationsgrenen. Hvis pullanmodningen angiver, at denne test mislykkedes, skal du afstemme det indhold, der forårsager flettekonflikten, før behandlingen kan fortsætte.
- CLA (Contribution License Agreement): Hvis du bidrager til et offentligt lager som ikke-Microsoft-bidragyder, bliver du muligvis bedt om at udfylde en kort CLA, første gang du sender en pullanmodning til det pågældende lager. Når CLA-trinnet er ryddet, behandles din pullanmodning.
- Mærkning: Mærkater anvendes automatisk på pullanmodningen for at angive tilstanden for din pullanmodning, når den passerer gennem valideringsarbejdsprocessen. Nye pullanmodninger kan f.eks. automatisk modtage mærkaten "do-not-merge", hvilket angiver, at pullanmodningen endnu ikke har fuldført validerings-, gennemgangs- og sign-off-trinnene.
- Validering og build: Automatisk kontrol af, om dine ændringer kan bestå valideringstestene. Valideringstestene kan give advarsler eller fejl, hvilket kræver, at du redigerer en eller flere filer i din pullanmodning, før den kan flettes. Resultaterne af valideringstesten tilføjes som en kommentar i din pullanmodning til gennemsyn, og de sendes muligvis til dig via mail.
- Midlertidig lagring: Når valideringen og buildet er fuldført, installeres de artikler, du har ændret, automatisk i et midlertidigt miljø til gennemsyn. URL-adresser til gennemgang vises i en kommentar til pull-anmodningen.
- Automatisk fletning: Pullanmodningen kan flettes automatisk, hvis den består valideringstest og visse kriterier. I dette tilfælde behøver du ikke at foretage dig andet.
Gennemse og adresser feedback
Når al behandling af pullanmodninger er fuldført, skal du gennemse resultaterne (f.eks. kommentarer til pullanmodninger, buildresultater). Find ud af, om du har brug for at foretage flere ændringer, før du logger af til fletning. Du skal muligvis ændre dit indhold af en af følgende årsager:
- PR-kommentarer fra korrekturlæsere. Hvis en korrekturlæser af pullanmodningen har gennemgået din pullanmodning, kan vedkommende give feedback via kommentarer, hvis der er udestående problemer eller spørgsmål, der skal løses, før fletningen.
- Feedback fra peer reviewere.
- Formateringsrettelser på grund af gengivelsesproblemer.
- Valideringsfejl eller -advarsler.
- Flettekonflikter.
Hvis du har brug for at foretage ændringer, kan du redigere dit indhold direkte i pullanmodningen, eller du kan vende tilbage til VS Code for at foretage dine ændringer. Når du er færdig, skal du bekræfte dine ændringer i din arbejdsgren. Pullanmodningen opdateres automatisk med dine ændringer.
Hver gang du føjer en bekræftelse til den samme arbejdsgren, føjes bekræftelsen automatisk til pullanmodningen. Med hver bekræftelse kører udgivelsessystemet automatisk validerings- og korrekturprocesserne igen.
Automatisering af sign-off og kommentar
Når du har håndteret alle feedback- og valideringsfejl, og du er klar til at flette dine ændringer, er det tid til at logge af din pullanmodning ved at oprette en ny kommentar, der læser #sign-off. Du skal angive kommentaren #sign-off for at flette ændringerne. Selvom alle korrekturer og valideringskontroller består, er du ansvarlig for at bruge denne kommentar til at fortælle korrekturlæsere og lageradministratorer, at dine ændringer er klar til fletning.
Når korrekturlæserne finder ud af, at din pullanmodning er gratis og logget af, flettes dine ændringer til standardforgreningen, og pullanmodningen lukkes.
Automatisering af kommentarer gør det muligt for brugere, der ikke har skriverettigheder i et lager, at udføre en handling på skriveniveau ved at tildele det relevante navn til en pullanmodning. Hvis du arbejder i et lager, hvor automatisering af kommentarer er implementeret, skal du bruge hashtagkommentarerne i følgende tabel til at tildele etiketter, ændre mærkater eller lukke en pullanmodning. Microsoft-forfattere får også besked via mail til gennemsyn og sign-off, når der foreslås ændringer i deres artikler.
| Hashtagkommentar | Hvad den gør |
|---|---|
#sign-off |
Tildeler automatisk mærkaten klar til fletning , så korrekturlæserne i lageret ved, at pullanmodningen er klar til gennemsyn/fletning. Hvis du ikke er den angivne forfatter og forsøger at logge af en offentlig lageranmodning ved hjælp af kommentaren #sign-off, opdateres pullanmodningen for at angive, at det kun er forfatteren, der kan tildele etiketten. |
#hold-off |
Fjerner mærkaten klar til fletning , hvis du skifter mening eller laver en fejl. Det medfører, at anmodningen tildeles navnet do-not-merge i det private lager. |
#please-close |
Lukker pullanmodningen, hvis du beslutter ikke at flette ændringerne. |
#please-open |
Åbner en lukket pullanmodning eller et problem igen. |
Publicering
Din pullanmodning skal flettes af en korrekturlæser af pullanmodninger, før ændringerne kan medtages i den næste planlagte udgivelseskørsel. Normalt gennemgås og flettes pullanmodninger i rækkefølgen af indsendelsen.
Når dine bidrag er godkendt og flettet, samler publiceringsprocessen dem op. Afhængigt af det team, der administrerer det lager, du bidrager til, kan udgivelsestiden variere, men de forekommer typisk mindst én gang hver ugedag. Der kan gå op til 45 minutter efter publiceringen, inden artikler vises.
Når dine ændringer er publiceret, går de live på Microsoft Learn, så andre kan begynde at lære af dem!
Næste trin
Det var det! Du har bidraget til Microsoft Learn-indhold!