Delen via

Open pull-aanvragen controleren in GitHub

  • Artikel

In dit artikel wordt uitgelegd hoe u een bijdrage kunt leveren aan Microsoft Learn door pull-aanvragen (PULL's) te bekijken en uw opmerkingen toe te voegen. U kunt nieuwe onderwerpen lezen en voorgestelde updates bekijken voordat ze worden gepubliceerd door de open PULL-wachtrij van een openbare GitHub-opslagplaats te controleren. Feedback uit de community over voorgestelde updates is nuttig voor de gehele community.

Met pr-opmerkingen en beoordelingen kunt u het volgende doen:

  • Opmerkingen toevoegen en beantwoorden in de pull-aanvraag.
  • Reageren op opmerkingen met emoji's zoals 👍, ❤️ en 🎉 .

Vereisten

Een pull-aanvraag zoeken

  1. Navigeer in uw browser naar de opslagplaats in GitHub die u wilt controleren. Als u niet zeker weet welke opslagplaats u moet bekijken, zoekt u een opslagplaats die u interesseert in onze lijst met Microsoft Learn-opslagplaatsen.

    Als u door de documentatie bladert en niet weet tot welke opslagplaats deze behoort, selecteert u het potloodpictogram bewerken boven aan de pagina. Met deze actie gaat u naar het bronbestand op GitHub. De naam van de opslagplaats wordt weergegeven in de linkerbovenhoek van de pagina. In de volgende afbeelding ziet u bijvoorbeeld de locatie van de opslagplaatsnaam voor de azure-dev-docs opslagplaats.

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

  2. Kies het tabblad Pull-aanvragen om de geopende PULL-aanvragen voor die opslagplaats weer te geven. Als de opslagplaats veel PULL's heeft, gebruikt u de filterbalk om te filteren op label, auteur en meer. Of gebruik de zoekbalk om te zoeken naar specifieke query's.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Open een pull-aanvraag door de titelkoppeling te selecteren.

Een pull-aanvraag controleren

  1. Selecteer in de pull-aanvraag die u bekijkt het tabblad Bestanden gewijzigd .

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

  2. Vergelijk het oorspronkelijke document met het bewerkte document. Het oorspronkelijke document is rood en het voorgestelde document is groen. Alle toegevoegde tekst wordt gemarkeerd in de groene (nieuwe) sectie en alle verwijderde tekst wordt gemarkeerd in de rode (oorspronkelijke) sectie.

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

  3. Voeg opmerkingen toe of stel wijzigingen voor door het pluspictogram (+) links van de regel te selecteren waarop u een opmerking wilt plaatsen. Als u meerdere lijnen wilt selecteren, selecteert en sleept u het plusteken.

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

    U kunt alleen opmerkingen of suggesties toevoegen aan regels die zijn bewerkt in de huidige pull-aanvraag. Als u andere wijzigingen wilt aanbrengen, bewerkt u dat bestand in uw eigen pull-aanvraag.

  4. Er wordt een vak geopend. Voer daar uw opmerkingen of vragen in. U kunt desgewenst de knoppen op de werkbalk gebruiken om tekst op te maken, lijsten met opsommingstekens en genummerde lijsten toe te voegen of codeblokken en afbeeldingen in te voegen.

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

  5. U kunt ook een wijziging in de tekst op die regel voorstellen.

    1. Selecteer in de werkbalk voor de opmerking het +- pictogram (waarschijnlijk het pictogram dat het meest links is). Dit is de knop Een suggestie invoegen.

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

    2. De tekst van de geselecteerde regel wordt opgenomen in een codeblok (binnen twee sets 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.

      Als u wijzigingen in tekst wilt voorstellen die een driedubbele codeheining ('') bevatten, vervangt u de buitenste/omsluitende suggestion backticks door tildes (~~~).

    3. Bewerk de tekst. Gebruik de knoppen in het opmerkingenvak voor eenvoudige opmaak, zoals vet, cursief en opsommingstekens, of gebruik de Markdown-syntaxiselementen rechtstreeks. U kunt ook opmerkingen toevoegen aan dit vak onder de sectie met codeblokken.

  6. Nadat u uw opmerking hebt gemaakt, selecteert u Een beoordeling starten. De auteur van de pull-aanvraag ontvangt een melding van uw wijzigingen. Als u in de vorige stap de knop Een suggestie invoegen hebt gebruikt, kan de auteur uw suggestie rechtstreeks doorvoeren in het document.

    Als u iemand anders in het gesprek wilt brengen, kunt u andere inzenders @mention door hun GitHub-alias in uw opmerkingen. Vermelde GitHub-gebruikers ontvangen een e-mailbericht met uw opmerking. U kunt Markdown ook gebruiken in uw opmerkingen en de Markdown van uw opmerking wordt weergegeven zodra u de opmerking hebt verzonden.

  7. Lees op het tabblad Gesprekken de opmerkingen door. Als u vragen of opmerkingen hebt, voegt u deze toe aan het gesprek. U kunt ook reacties toevoegen aan opmerkingen door het lachebekje in de linkerbenedenhoek van elke opmerking te selecteren.

Een beoordeling verzenden

Nadat u al uw opmerkingen aan de beoordeling hebt toegevoegd, dient u uw beoordeling in.

  1. Selecteer de knop Wijzigingen controleren in de rechterbovenhoek van het tabblad Bestanden die zijn gewijzigd om het dialoogvenster Beoordelingsverzending te openen.
  2. Voer een beschrijvende beoordelingssamenvatting in.
  3. Selecteer het keuzerondje voor het gewenste beoordelingstype en kies Vervolgens Verzenden beoordeling.

Submitting a review in GitHub.

De auteur van de pull-aanvraag ontvangt een melding van de beoordeling.

Volgende stappen

Raadpleeg deze artikelen in de documentatie van GitHub voor meer informatie over opmerkingen en beoordelingen.