Sdílet prostřednictvím

Zpracování žádosti o přijetí změn

  • Článek

Po otevření žádosti o přijetí změn projde žádost o přijetí změn sadou kontrol a kontrol, aby se zajistilo, že se navrhované změny dají sloučit. Další informace o žádostech o přijetí změn najdete v tématu Git a GitHub – základy.

Ověření

Před sloučením žádosti o přijetí změn do cílové větve může být nutné projít jedním nebo více procesy ověřování žádostí o přijetí změn. Jakmile vyberete Vytvořit žádost o přijetí změn, GitHub spustí ověření nakonfigurovaná pro vaše úložiště. Po dokončení procesu ověření se výsledky zobrazí v žádosti o přijetí změn.

Procesy ověřování se liší v závislosti na rozsahu navrhovaných změn a pravidlech cílového úložiště. Po odeslání žádosti o přijetí změn můžete očekávat, že dojde k jedné nebo několika z následujících akcí:

  • Sloučitelnost: Nejprve se provede základní test sloučení GitHubu, který ověří, jestli navrhované změny ve vaší větvi kolidují s cílovou větví. Pokud žádost o přijetí změn indikuje, že tento test selhal, musíte před pokračováním zpracování odsouhlasit obsah, který způsobuje konflikt při sloučení.
  • Licenční smlouva s příspěvkem (CLA):Pokud přispíváte do veřejného úložiště jako přispěvatel jiného než Microsoftu, můžete být požádáni o dokončení krátké smlouvy CLA při prvním odeslání žádosti o přijetí změn do tohoto úložiště. Po vymazání kroku CLA se vaše žádost o přijetí změn zpracuje.
  • Popisky: Popisky se automaticky použijí pro vaši žádost o přijetí změn, aby označily stav žádosti o přijetí změn při průchodu pracovním postupem ověření. Nové žádosti o přijetí změn můžou například automaticky obdržet popisek "do-not-merge", což znamená, že žádost o přijetí změn ještě nedokončila kroky ověření, kontroly a odhlášení.
  • Ověření a sestavení: Automatizované kontroly ověřují, zda vaše změny projdou ověřovacími testy. Ověřovací testy můžou přinést upozornění nebo chyby, které vyžadují, abyste před sloučením upravili jeden nebo více souborů v žádosti o přijetí změn. Výsledky ověřovacího testu se přidají jako komentář do žádosti o přijetí změn pro vaši recenzi a můžou se vám poslat e-mailem.
  • Příprava: Po úspěšném ověření a sestavení se články, které jste změnili, automaticky nasadí do přípravného prostředí pro kontrolu. V komentáři k žádosti o přijetí změn se zobrazí adresy URL náhledu.
  • Automatické sloučení: Žádost o přijetí změn se může automaticky sloučit, pokud projde ověřovacím testováním a určitými kritérii. V takovém případě nemusíte dělat nic jiného.

Kontrola a řešení zpětné vazby

Po dokončení veškerého zpracování žádosti o přijetí změn byste měli zkontrolovat výsledky (například komentáře k žádosti o přijetí změn, výsledky sestavení). Než se odhlásíte ke sloučení, určete, jestli potřebujete udělat další změny. Možná budete muset změnit obsah z některého z následujících důvodů:

  • Komentáře k žádosti o přijetí změn od revidujících Pokud kontrolor žádosti o přijetí změn zkontroloval vaši žádost o přijetí změn, může prostřednictvím komentářů poskytnout zpětnou vazbu, pokud se před sloučením nevyřeší problémy nebo dotazy.
  • Zpětná vazba od partnerských revidujících
  • Opravy formátování kvůli problémům s vykreslováním
  • Chyby nebo upozornění ověřování.
  • Konflikty při slučování

Pokud potřebujete provést změny, můžete upravit obsah přímo v žádosti o přijetí změn nebo se můžete vrátit do nástroje VS Code a provést změny. Až budete hotovi, potvrďte změny do pracovní větve. Žádost o přijetí změn se automaticky aktualizuje o vaše změny.

Pokaždé, když přidáte potvrzení do stejné pracovní větve, potvrzení se automaticky přidá do žádosti o přijetí změn. Při každém potvrzení systém publikování znovu spustí procesy ověřování a kontroly automaticky.

Odhlášení a automatizace komentářů

Když jste vyřešili všechny chyby zpětné vazby a ověření a jste připraveni ke sloučení změn, je čas se odhlásit k žádosti o přijetí změn vytvořením nového komentáře, který přečte #sign-off. Pokud chcete sloučit změny, musíte zadat #sign-off komentář. I když všechny kontroly kontrol kontrol a ověření proběhnou úspěšně, zodpovídáte za použití tohoto komentáře, abyste revidujícím žádosti o přijetí změn a správcům úložiště řekli, že vaše změny jsou připravené ke sloučení.

Když kontroloři zjistí, že vaše žádost o přijetí změn je bez problémů a odhlášována, změny se sloučí do výchozí větve a žádost o přijetí změn se zavře.

Automatizace komentářů umožňuje uživatelům, kteří nemají v úložišti oprávnění k zápisu, dokončit akci na úrovni zápisu přiřazením příslušného popisku žádosti o přijetí změn. Pokud pracujete v úložišti, kde byla implementována automatizace komentářů, použijte komentáře hashtagu uvedené v následující tabulce a přiřaďte popisky, změňte popisky nebo zavřete žádost o přijetí změn. Autoři Microsoftu budou také upozorněni e-mailem na kontrolu a odhlášení při každém návrhu změn ve svých článcích.

Hashtagový komentář Jak funguje
#sign-off Automaticky přiřadí popisek připravený ke sloučení , aby kontroloři v úložišti věděli, že žádost o přijetí změn je připravená ke kontrole nebo sloučení.

Pokud nejste autorem seznamu a zkuste se přihlásit k žádosti o přijetí změn veřejného úložiště pomocí #sign-off komentáře, žádost o přijetí změn se aktualizuje a indikuje, že popisek může přiřadit jenom autor.
#hold-off Odebere popisek připravený ke sloučení pro případ, že změníte názor nebo uděláte chybu. V soukromém úložišti se tím přiřadí označení do-not-merge (neslučovat).
#please-close Zavře žádost o přijetí změn, pokud se rozhodnete, že změny nebudou sloučeny.
#please-open Znovu otevře uzavřenou žádost o přijetí změn nebo problém.

Publikování

Vaši žádost o přijetí změn musí sloučit kontrolor žádosti o přijetí změn, aby bylo možné změny zahrnout do dalšího naplánovaného spuštění publikování. Za normálních okolností se žádosti o přijetí změn kontrolují a slučují v pořadí odeslání.

Po schválení a sloučení příspěvků je proces publikování vybere. V závislosti na týmu, který spravuje úložiště, do kterého přispíváte, se časy publikování můžou lišit, ale obvykle se vyskytují alespoň jednou týdně. Po publikování může trvat až 45 minut, než se články zobrazí online.

Jakmile budou vaše změny publikovány, přejdou na Microsoft Learn, aby se ostatní mohli učit.

Další kroky

A je to! Přispěli jste k obsahu Microsoft Learn.