Jaa

Avointen pull-pyyntöjen tarkistus GitHubissa

  • Artikkeli

Tässä artikkelissa kerrotaan, miten voit osallistua Microsoft Learniin tarkastelemalla pull-pyyntöjä (PULL-pyyntöjä) ja lisäämällä kommentteja. Voit lukea uusia aiheita ja tarkastella ehdotettuja päivityksiä ennen niiden julkaisua tarkistamalla julkisen GitHub-säilön avoimen PR-jonon. Yhteisön palaute ehdotetuista päivityksistä auttaa koko yhteisöä.

PR-kommenteilla ja arvosteluilla voit tehdä seuraavaa:

  • Lisää pull-pyynnön kommentteihin ja vastaa niihin.
  • Reagoi kommentteihin emojeissa, kuten 👍, ❤️ ja 🎉 .

Edellytykset

Pull-pyynnön etsiminen

  1. Siirry selaimella GitHubin säilöön, jonka haluat tarkastella. Jos et ole varma, mitä säilöä haluat tarkastella, etsi sitä kiinnostava säilö Microsoft Learn -säilöluettelostamme.

    Jos selaat ohjeita etkä tiedä, mihin säilöön se kuuluu, valitse sivun yläosasta Muokkaa-kynäkuvake . Tämä toiminto vie sinut Lähdetiedostoon GitHubissa. Säilön nimi näkyy sivun vasemmassa yläkulmassa. Esimerkiksi seuraavassa kuvassa näytetään säilön nimen sijainti azure-dev-docs .

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Valitse Pull-pyynnöt-välilehti, jotta näet kyseisen säilön avoimet PR:t. Jos säilössä on paljon PULL-pyyntöjä, suodata selitteen, tekijän ja muiden tietojen mukaan Suodattimet-palkin avulla. Voit myös etsiä tiettyjä kyselyitä hakupalkin avulla.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Avaa PULL-pyyntö valitsemalla otsikkolinkki.

Tarkista PULL-pyyntö

  1. Valitse tarkistettavassa PULL-pyynnössä Tiedostot muutettu -välilehti.

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Vertaa alkuperäistä asiakirjaa muokattuun asiakirjaan. Alkuperäinen asiakirja on punaisella ja ehdotettu asiakirja on vihreä. Kaikki lisätyt tekstit korostetaan vihreässä (uusi) osiossa, ja poistettu teksti korostetaan punaisessa (alkuperäisessä) osassa.

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Lisää kommentteja tai ehdota muutoksia valitsemalla plusmerkki (+) sen rivin vasemmalta puolelta, jota haluat kommentoida. Valitse useita rivejä valitsemalla plusmerkki ja vetämällä sitä.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Voit lisätä kommentteja tai ehdotuksia vain riveille, joita on muokattu nykyisessä pull-pyynnössä. Jos haluat tehdä muita muutoksia, muokkaa tiedostoa omalla pull-pyynnölläsi.

  4. Näyttöön avautuu laatikko. Anna kommenttisi tai kysymyksesi siellä. Työkalurivin painikkeilla voit halutessasi muotoilla tekstiä, lisätä luettelomerkeillä varustettuja ja numeroituja luetteloita tai lisätä koodilohkoja ja kuvia.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Voit myös ehdottaa muutosta kyseisen rivin tekstiin.

    1. Valitse kommentin työkalurivillä oleva +- kuvake (luultavasti kauimpana vasemmalla). Tämä on Lisää ehdotus -painike.

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. Valitsemasi rivin teksti sisällytetään koodilohkoon (kahden """-taustajoukkojoukon sisällä).

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Jos haluat ehdottaa muutoksia tekstiin, joka sisältää kolminkertaisten jaksojen koodiaidan (''),korvaa ulompi/sulkeva suggestion grastari aaltoviivoilla (~~~).

    3. Muokkaa tekstiä. Käytä kommenttiruudun painikkeita yksinkertaiseen muotoiluun, kuten lihavointiin, kursivointiin ja luettelomerkeihin, tai käytä suoraan Markdown-syntaksielementtejä . Voit myös lisätä kommentteja tähän ruutuun koodilohko-osion alla.

  6. Kun olet kommentoinut asiaa, valitse Aloita arvostelu. PR:n tekijälle ilmoitetaan muutoksistasi. Jos käytit edellisessä vaiheessa Lisää ehdotus -painiketta, tekijä voi sitoa ehdotuksesi suoraan asiakirjaan.

    Jos haluat tuoda jonkun muun keskusteluun, voit @mention muita osallistujia heidän GitHub-aliaksensa avulla kommenteissasi. Mainitut GitHub-käyttäjät saavat sähköpostiviestin, joka sisältää kommenttisi. Voit myös käyttää Markdown-syntaksia kommenteissasi ja kommenttisi Markdown hahmonnetaan, kun lähetät kommentin.

  7. Lue Keskustelut-välilehdessä kommenttien läpi. Jos sinulla on kysymyksiä tai kommentteja, lisää ne keskusteluun. Voit myös lisätä reaktioita kommentteihin valitsemalla hymiökuvakkeen kunkin kommentin vasemmasta alakulmasta.

Lähetä arvostelu

Kun olet lisännyt kaikki kommenttisi arvosteluun, lähetä arvostelusi.

  1. Valitse Tarkista muutokset -painike Tiedostot, joita on muutettu -välilehden oikeasta yläkulmasta, jotta voit avata tarkistuksen lähetyssumman valintaikkunan.
  2. Anna kuvaava tarkistusyhteenveto.
  3. Valitse haluamasi tarkistustyypin valintanappi ja valitse sitten Lähetä arvostelu.

Submitting a review in GitHub.

PR:n tekijä saa ilmoituksen tarkistamisesta.

Seuraavat vaiheet

Jos haluat lisätietoja kommentoinnista ja tarkistuksista, tutustu näihin artikkeleihin GitHubin dokumentaatiossa.