Jaa

Pull-pyynnön käsitteleminen

  • Artikkeli

Kun olet avannut pull-pyynnön (PR), pull-pyyntö tarkistetaan ja tarkistetaan, jotta ehdotettuja muutoksia voidaan yhdistää. Jos haluat lisätietoja PR:istä, tutustu Gitin ja GitHubin perusteisiin.

Vahvistus

Pull-pyyntö voidaan yhdistää kohdehaaraan ennen kuin se voidaan yhdistää kohdehaaraan, ja sen täytyy ehkä suorittaa yksi tai useampi PR-vahvistusprosessi. Kun olet valinnut Luo pull-pyyntö, GitHub suorittaa säilöllesi määritetyt vahvistukset. Kun tarkistusprosessi on valmis, tulokset näkyvät pull-pyynnössä.

Vahvistusprosessit vaihtelevat ehdotettujen muutosten laajuuden ja kohdesäilön sääntöjen mukaan. Pull-pyynnön lähettämisen jälkeen voi tapahtua yksi tai useampi seuraavista:

  • Yhdistettävyys: Perustason GitHub-yhdistettävyyskoe suoritetaan ensin, jotta voidaan tarkistaa, ovatko haarasi ehdotetut muutokset ristiriidassa kohdehaaran kanssa. Jos pull-pyyntö ilmaisee, että tämä testi epäonnistui, sinun on täsmäytettävä yhdistämisristiriidan aiheuttava sisältö, ennen kuin käsittelyä voidaan jatkaa.
  • Osallistujien käyttöoikeussopimus: Jos osallistut julkisen säilön sisällöntuottamiseen muuna osallistujana, sinua saatetaan pyytää täyttämään lyhyt CLA-käyttöoikeus, kun lähetät pr:n kyseiseen säilöön ensimmäisen kerran. Kun CLA-vaihe on suoritettu, pull-pyyntösi käsitellään.
  • Tunnisteet: Pull-pyyntöihin lisätään automaattisesti tunnisteet, jotka ilmaisevat pull-pyyntösi tilan vahvistusprosessissa. Esimerkiksi uudet PR:t saattavat saada automaattisesti "do-not-merge"-merkinnän, joka ilmaisee, että PULL-pyyntö ei ole vielä suorittanut vahvistus-, tarkastus- ja hyväksyntävaiheita.
  • Vahvistus ja koostaminen: Automaattiset tarkastukset varmistavat, läpäisevätkö muutokset vahvistustestit. Vahvistustestit saattavat palauttaa varoituksia tai virheitä, jotka edellyttävät yhden tai useamman pull-pyynnön tiedoston muokkaamista, ennen kuin se voidaan yhdistää. Vahvistustestin tulokset lisätään kommenttina pull-pyyntöön tarkistettavaksi ja ne voidaan lähettää sinulle sähköpostitse.
  • Valmistelu: Kun vahvistus ja koostaminen onnistuu, muuttamasi artikkelit otetaan automaattisesti käyttöön valmisteluympäristössä tarkistettavaksi. Esikatselun URL-osoitteet näkyvät PR-kommentissa.
  • Automaattinen yhdistäminen: Pull-pyyntö voidaan yhdistää automaattisesti, jos se läpäisee vahvistustestauksen ja tietyt ehdot. Tässä tapauksessa sinun ei tarvitse tehdä mitään muuta.

Arvostelun ja palautteen käsitteleminen

Kun PR-käsittely on valmis, tarkista tulokset (esimerkiksi PR-kommentit, koostamistulokset). Selvitä, onko sinun tehtävä enemmän muutoksia, ennen kuin kirjaudut yhdistämistä varten. Sinun on ehkä muutettava sisältöäsi seuraavista syistä:

  • Tarkistajien PR-kommentit. Jos PR-tarkistaja on tarkistanut pull-pyyntösi, hän voi antaa palautetta kommenteilla, jos hän kohtaa avoimia ongelmia tai kysymyksiä, jotka on ratkaistava ennen yhdistämistä.
  • Vertaisarvioijien palaute.
  • Muotoilukorjauksia hahmontamisongelmien vuoksi.
  • vahvistusvirheet tai varoitukset.
  • Yhdistämisristiriidat.

Jos sinun on tehtävä muutoksia, voit muokata sisältöä suoraan PULL-pyynnössä tai palata VS Codeen ja tehdä muutokset. Kun olet valmis, vahvista muutoksesi työhaaraan. Pull-pyyntö päivittyy automaattisesti tekemiesi muutosten mukaisesti.

Aina, kun lisäät vahvistusta samaan toimivaan haaraan, vahvistus lisätään automaattisesti PULL-pyyntöön. Kunkin vahvistuksen yhteydessä julkaisujärjestelmä tarkistaa vahvistus- ja tarkistusprosessit automaattisesti.

Kuittaaminen ja kommentoinnin automatisointi

Kun olet käsitellyt kaikki palaute- ja vahvistusvirheet #sign-offja olet valmis muutosten yhdistämiseen, on aika kuitata pull-pyyntösi luomalla uusi kommentti, jossa lukee . Sinun on annettava kommentti, #sign-off jotta voit yhdistää muutoksesi. Vaikka kaikki tarkistukset ja vahvistustarkistukset läpäisevät, sinun vastuullasi on tämän kommentin avulla kertoa PR-tarkistajille ja säilön järjestelmänvalvojille, että tekemäsi muutokset ovat valmiita yhdistämistä varten.

Kun tarkistajat määrittävät, että pull-pyyntösi on maksuton ja että se on kuittattu käytöstä, muutoksesi yhdistetään oletushaaraan ja pull-pyyntö suljetaan.

Kommenttien automaation avulla käyttäjät, joilla ei ole säilössä kirjoitusoikeuksia, voivat kirjoittaa kirjoitus-tason toiminnon määrittämällä pr:lle asianmukaisen merkinnän. Jos käsittelet säilöä, jossa kommenttien automaatio on otettu käyttöön, voit lisätä merkintöjä, muuttaa merkintöjä tai sulkea PR: n käyttämällä seuraavassa taulukossa lueteltuja aihetunnistekommentteja . Microsoftin kirjailijoita pyydetään sähköpostitse tarkistamaan ja kuittaamaan ne aina, kun heidän artikkeleihinsa ehdotetaan muutoksia.

Aihetunnistekommentti Toiminnot
#sign-off Määrittää automaattisesti ready-to-merge-selitteen , jotta säilön tarkistajat tietävät, että PULL-pyyntö on valmis tarkistettavaksi/yhdistettäväksi.

Jos et ole artikkelin tekijä ja yrität hyväksyä säilön julkisen pull-pyynnön -kommentilla #sign-off , PULL-pyyntö päivitetään osoittamaan, että vain tekijä voi lisätä merkinnän.
#hold-off Poistaa ready-to-merge-selitteen siltä varalta, että muutat mielesi tai teet virheen. Yksityisessä säilössä tämä lisää do-not-merge -merkinnän.
#please-close Jos päätät, ettei muutoksia yhdistetä, pull-pyyntö suljetaan.
#please-open Avaa suljetun pull-pyynnön tai ongelman uudelleen.

Julkaistaan

PR-tarkistajan on yhdistettävä pull-pyyntösi, ennen kuin muutokset voidaan sisällyttää seuraavaan ajoitettuun julkaisuun. Pull-pyyntöjä tarkastellaan ja yhdistetään tavallisesti lähetysjärjestyksessä.

Kun panoksesi on hyväksytty ja yhdistetty, julkaisuprosessi poimii ne. Julkaisuajat vaihtelevat, mutta yleensä ne suoritetaan vähintään kerran arkipäivässä sen mukaan, mikä säilö on, johon osallistut. Tavallisesti kestää enintään 45 minuuttia, ennen kuin julkaistu artikkeli näkyy verkossa.

Kun tekemäsi muutokset on julkaistu, ne julkaistaan Microsoft Learnissa, josta muut voivat aloittaa opiskelun!

Seuraavat vaiheet

Siinä kaikki! Olet osallistunut Microsoft Learn -sisältöön!