Spracovanie žiadosti o prijatie zmien

Po otvorení žiadosti o prijatie zmien (PR) pr prejde súborom kontrol a recenzií, aby sa navrhované zmeny mohli zlúčiť. Ďalšie podrobnosti o žiadostiach o prijatie zmien nájdete v téme Základy systémov Git a GitHub.

Overenie

Predtým, ako sa vaša PR bude môcť zlúčiť do cieľovej vetvy, môže sa vyžadovať, aby prešla cez jeden alebo viac overovacích procesov PR. Po výbere možnosti Vytvoriť žiadosť o prijatie zmien spustí GitHub overenia nakonfigurované pre váš odkladací priestor. Po dokončení procesu overenia sa výsledky zobrazia v žiadosti o prijatie zmien.

Overovacie procesy sa líšia v závislosti od rozsahu navrhovaných zmien a pravidiel cieľového odkladacieho priestoru. Po odoslaní žiadosti o prijatie zmien môžete očakávať jednu alebo viaceré z týchto možností:

• Zlučiteľnosť: Najskôr sa vykoná základný test zlučiteľnosti služby GitHub, ktorý overí, či navrhované zmeny vo vašej vetve sú v rozpore s cieľovou vetvou. Ak žiadosť o prijatie zmien naznačí, že tento test zlyhal, pred pokračovaním spracovania musíte zosúladiť obsah, ktorý spôsobuje konflikt pri zlučovaní.
• Licenčná zmluva o prispievaní (CLA): Ak ako prispievateľ mimo spoločnosti Microsoft prispievate do verejného odkladacieho priestoru, môže sa stať, že budete požiadaní, aby ste pri prvom odoslaní žiadosti o prijatie zmien do daného odkladacieho priestoru vyplnili krátku licenčnú zmluvu na používateľa. Po vymažení kroku so clami sa pr spracuje.
• Označovanie: Menovky sa automaticky použijú vo vašej žiadosti o prijatie zmien na označenie stavu žiadosti o prijatie zmien počas jeho prechodu pracovným postupom overovania. Nové žiadosti o prijatie zmien môžu napríklad automaticky získať označenie nezlučovať, čo označuje, že ŽIADOSŤ o prijatie zmien ešte neukončila kroky overenia, revízie a dokončenia.
• Validácia a vytvorenie: Automatizované kontroly overia, či vaše zmeny prejdú testom overenia. Testy overenia môžu vynášať upozornenia alebo chyby a vyžadovať, aby ste pred zlúčením upravili jeden alebo viac súborov v ŽIADOSTI o prijatie zmien. Výsledky testov overenia sa pridajú ako komentár do žiadosti o prijatie zmien na kontrolu a môžu sa odoslať e-mailom.
• Pracovná verzia: Po úspešnom overení a vytvorení sa zmenené články automaticky nasadia do prostredia pracovnej verzie na kontrolu. URL adresy ukážky sa zobrazia v komentári PR.
• Automatické zlúčenie: Žiadosť o prijatie zmien sa môže automaticky zlúčiť, ak prejde testom overenia a splní určité kritériá. V tomto prípade nemusíte robiť nič iné.

Kontrola a riešenie pripomienok

Po dokončení spracovania všetkých PR by ste mali skontrolovať výsledky (napríklad komentáre PR, výsledky vytvárania). Pred dokončením zlúčenia zistite, či potrebujete vykonať ďalšie zmeny. Možno bude potrebné zmeniť obsah z ktoréhokoľvek z týchto dôvodov:

• Komentáre PR od posudzovateľov. Ak posudzovateľ PR preskúmal vašu žiadosť o prijatie zmien, môže v prípade, že existujú nevyriešené problémy alebo otázky, ktoré treba vyriešiť pred zlúčením, poskytnúť spätnú väzbu prostredníctvom komentárov.
• Pripomienky od partnerských posudzovateľov.
• Opravy formátovania z dôvodu problémov s vykresľovaním.
• Chyby alebo upozornenia overenia.
• Zlúčenie konfliktov.

Ak potrebujete vykonať zmeny, môžete obsah upraviť priamo v žiadosti o prijatie zmien alebo sa môžete vrátiť do programu VS Code a vykonať zmeny. Po dokončení potvrďte zmeny do pracovnej vetvy. Pr sa automaticky aktualizuje vašimi zmenami.

Vždy, keď pridáte potvrdenie do tej istej pracovnej vetvy, potvrdenie sa automaticky pridá do PR. S každým potvrdením systém publikovania automaticky opakovane spustí procesy overenia a kontroly.

Odhlásenie a automatizácia komentárov

Keď ste vyriešili všetky chyby spätnej väzby a overenia a ste pripravení na zlúčenie zmien, je čas prihlásiť sa do pr vytvorením nového komentára, ktorý bude #sign-offčítať . Ak chcete zmeny zlúčiť, musíte zadať #sign-off komentár. Aj v prípade úspešného absolvovania všetkých recenzií a overovacích kontrol je zodpovedný za použitie tohto komentára, ktorý posudzovateľom PR a správcom odkladacieho priestoru oznámi, že vaše zmeny sú pripravené na zlúčenie.

Keď posudzovatelia zistia, že vaše PR je bez problémov a podpísané, vaše zmeny sa zlúčia do predvolenej vetvy a PR sa uzavrie.

Automatizácia komentárov umožňuje používateľom, ktorí nemajú v odkladacom priestore povolenia na zápis, dokončiť akciu na úrovni zápisu priradením príslušného označenia k PR. Ak pracujete v odkladacom priestore, v ktorom bola implementovaná automatizácia komentárov, použite komentáre hashtagu uvedené v nasledujúcej tabuľke na priradenie označení, zmenu označení alebo zavretie PR. Autori spoločnosti Microsoft budú tiež upozornení prostredníctvom e-mailu na preskúmanie a odhlásenie vždy, keď sa navrhnú zmeny v ich článkoch.

Komentár typu hashtag	Čo urobí
#sign-off	Automatické priradenie označenia pripravené na zlúčenie umožní posudzovateľom v odkladacom priestore zistiť, že PR je pripravené na kontrolu/zlúčenie. Ak nie ste uvedený ako autor a pokúsite sa pomocou komentára odhlásiť žiadosť o prijatie zmien vo verejnom odkladacom priestore#sign-off, žiadosť o prijatie zmien sa aktualizuje a uvedie, že označenie môže priradiť iba autor.
#hold-off	Odstráni označenie pripravené na zlúčenie v prípade, že zmeníte názor alebo urobíte chybu. V súkromnom odkladacom priestore sa priradí označenie nezlúčiť.
#please-close	Ak sa rozhodnete, že sa zmeny nezlučujú, zavrie sa žiadosť o prijatie zmien.
#please-open	Znovu otvorí uzavretú žiadosť o prijatie zmien alebo problém.

Publikuje sa

Pred zahrnutím zmien do ďalšieho plánovaného publikovania musí byť vaša PR posudzovateľom pr zlúčená. Žiadosti o prijatie zmien sa zvyčajne kontrolujú a zlučujú v poradí akom boli odoslané.

Po schválení a zlúčení vašich príspevkov si ich proces publikovania prevezme. Čas publikovania sa môže líšiť v závislosti od tímu, ktorý spravuje odkladací priestor, do ktorý prispievate, no zvyčajne sa vyskytuje aspoň raz za deň v týždni. Zobrazenie článkov online po publikovaní môže trvať až 45 minút.

Po publikovaní zmien prejdú naživo na lokalite Microsoft Learn, aby sa ostatní mohli začať učiť.

Ďalšie kroky

To je všetko! Prispeli ste do obsahu služby Microsoft Learn.