Del via

Se gjennom åpne pull-forespørsler i GitHub

  • Artikkel

Denne artikkelen forklarer hvordan du bidrar til Microsoft Learn ved å se gjennom pull-forespørsler og legge til kommentarer. Du kan lese nye emner og se foreslåtte oppdateringer før de publiseres ved å sjekke et offentlig GitHub-repositoriums åpne PR-kø. Tilbakemeldinger fra fellesskapet om foreslåtte oppdateringer hjelper hele fellesskapet.

Med PR-kommentarer og anmeldelser kan du:

  • Legg til og svar på kommentarer på pr.
  • Reagere på kommentarer med emojier som 👍, ❤️ og 🎉 .

Forutsetning

Finn en PR

  1. Gå til repositoriet i GitHub i nettleseren som du vil se gjennom. Hvis du ikke er sikker på hvilket repositorium du vil se på, kan du finne et som interesserer deg i listen over Microsoft Learn-repos.

    Hvis du blar gjennom dokumentasjonen og ikke vet hvilket repo det tilhører, velger du Rediger blyant-ikonet øverst på siden. Denne handlingen tar deg til kildefilen på GitHub. Repositoriumnavnet vises øverst til venstre på siden. Bildet nedenfor viser for eksempel plasseringen for reponavn for azure-dev-docs repo.

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

  2. Velg pull-forespørsler-fanen for å se de åpne PR-ene for det repositoriet. Hvis repo har mange PC-er, kan du bruke filterlinjen til å filtrere etter etikett, forfatter og mer. Du kan også bruke søkefeltet til å se etter bestemte spørringer.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Åpne en PR ved å velge tittelkoblingen.

Se gjennom en PR

  1. Velg Filer endret-fanen i pr-forespørselen du ser gjennom .

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

  2. Sammenlign det opprinnelige dokumentet med det redigerte dokumentet. Det opprinnelige dokumentet vil være i rødt, og det foreslåtte dokumentet vil være i grønt. Eventuell tekst som legges til, utheves i den grønne (nye) inndelingen, og eventuell slettet tekst utheves i den røde (opprinnelige) inndelingen.

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

  3. Legg til kommentarer eller foreslå endringer ved å velge plussikonet (+) til venstre for linjen du vil kommentere. Hvis du vil merke flere linjer, merker og drar du plusstegnet.

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

    Du kan bare legge til kommentarer eller forslag til linjer som er redigert i gjeldende pr. Hvis du vil gjøre andre endringer, redigerer du filen i din egen pr.

  4. En boks åpnes. Skriv inn kommentarer eller spørsmål der. Hvis du vil, kan du bruke knappene på verktøylinjen til å formatere teksten, legge til punktlister og nummererte lister eller sette inn kodeblokker og bilder.

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

  5. Du kan også foreslå en endring i teksten på den linjen.

    1. Velg ikonet +- (sannsynligvis ikonet lengst til venstre) på verktøylinjen for kommentaren. Dette er knappen Sett inn et forslag .

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

    2. Teksten fra linjen du valgte, inkluderes i en kodeblokk (innenfor to sett med ''' backticks).

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

      Hvis du vil foreslå endringer i tekst som inkluderer et tre-merket kodegjerde ('''), erstatter du de ytre/omsluttende suggestion backticks med fliser (~~~).

    3. Rediger teksten. Bruk knappene i kommentarboksen for enkel formatering som fet, kursiv og punktmerking, eller bruk Markdown-syntakselementene direkte. Du kan også legge til kommentarer i denne boksen under kodeblokkinndelingen.

  6. Når du har kommentert, velger du Start en gjennomgang. Pr-forfatteren vil bli varslet om endringene. Hvis du brukte Knappen Sett inn et forslag i forrige trinn, kan forfatteren utføre forslaget direkte til dokumentet.

    Hvis du vil hente noen andre inn i samtalen, kan du @mention andre bidragsytere ved hjelp av GitHub-aliaset i kommentarene dine. Omtalte GitHub-brukere vil motta en e-postmelding som inneholder kommentaren din. Du kan også bruke Markdown i kommentarene dine, og markdown-kommentaren gjengis når du sender inn kommentaren.

  7. Les gjennom kommentarene på Samtaler-fanen. Hvis du har spørsmål eller kommentarer, kan du legge dem til i samtalen. Du kan også legge til reaksjoner på kommentarer ved å velge smilefjesikonet nederst til venstre i hver kommentar.

Send inn en gjennomgang

Når du har lagt til alle kommentarene dine i anmeldelsen, kan du sende inn anmeldelsen.

  1. Velg Knappen Se gjennom endringer øverst til høyre på Filer endret-fanen for å åpne dialogboksen gjennomgangsinnsending.
  2. Skriv inn et beskrivende sammendrag for gjennomgang.
  3. Velg alternativknappen for ønsket korrekturtype, og velg deretter Send gjennomgang.

Submitting a review in GitHub.

Pr-forfatteren vil motta varsel om gjennomgangen.

Neste trinn

Hvis du vil lære mer om kommentering og anmeldelser, kan du se disse artiklene i GitHubs dokumentasjon.