Udostępnij za pośrednictwem

Przeglądanie otwartych żądań ściągnięcia w usłudze GitHub

  • Artykuł

W tym artykule wyjaśniono, jak współtworzyć usługę Microsoft Learn, przeglądając żądania ściągnięcia i dodając komentarze. Możesz przeczytać nowe tematy i zobaczyć proponowane aktualizacje przed ich opublikowaniem, sprawdzając publiczną kolejkę żądania ściągnięcia w repozytorium GitHub. Opinie członków społeczności na temat proponowanych aktualizacji pomagają całej społeczności.

Za pomocą komentarzy i przeglądów żądań ściągnięcia można wykonywać następujące czynności:

  • Dodaj i odpowiedz na komentarze dotyczące żądania ściągnięcia.
  • Reagowanie na komentarze za pomocą emoji, takich jak 👍, ❤️ i 🎉 .

Wymagania wstępne

Znajdowanie żądania ściągnięcia

  1. W przeglądarce przejdź do repozytorium w usłudze GitHub, które chcesz przejrzeć. Jeśli nie masz pewności, które repozytorium chcesz przejrzeć, znajdź je, które cię interesuje na naszej liście repozytoriów microsoft Learn.

    Jeśli przeglądasz dokumentację i nie wiesz, do którego repozytorium należy, wybierz ikonę ołówka Edytuj w górnej części strony. Ta akcja powoduje przejście do pliku źródłowego w usłudze GitHub. Nazwa repozytorium jest wyświetlana w lewym górnym rogu strony. Na przykład na poniższej ilustracji przedstawiono lokalizację nazwy repozytorium dla azure-dev-docs repozytorium.

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

  2. Wybierz kartę Żądania ściągnięcia, aby wyświetlić otwarte żądania ściągnięcia dla tego repozytorium. Jeśli repozytorium zawiera wiele żądań ściągnięcia, użyj paska Filtry, aby filtrować według etykiety, autora i nie tylko. Możesz też użyć paska wyszukiwania , aby wyszukać określone zapytania.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Otwórz żądanie ściągnięcia, wybierając link tytułu.

Przeglądanie żądania ściągnięcia

  1. W przeglądanych żądaniach ściągnięcia wybierz kartę Pliki zmienione .

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

  2. Porównaj oryginalny dokument z edytowanym dokumentem. Oryginalny dokument będzie czerwony, a proponowany dokument będzie zielony. Każdy dodany tekst zostanie wyróżniony w sekcji zielony (nowy), a wszystkie usunięte tekst zostaną wyróżnione w czerwonej (oryginalnej) sekcji.

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

  3. Dodaj komentarze lub zasugeruj zmiany, wybierając ikonę znaku plus (+) po lewej stronie wiersza, nad którym chcesz dodać komentarz. Aby wybrać wiele linii, zaznacz i przeciągnij znak plus.

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

    Komentarze lub sugestie można dodawać tylko do wierszy, które zostały edytowane w bieżącym żądaniu ściągnięcia. Aby wprowadzić inne zmiany, edytuj ten plik we własnym żądaniu ściągnięcia.

  4. Zostanie otwarte pole. Wprowadź tam swoje komentarze lub pytania. Jeśli chcesz, możesz użyć przycisków na pasku narzędzi, aby sformatować tekst, dodać listy punktowane i numerowane lub wstawić bloki kodu i obrazy.

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

  5. Możesz również zasugerować zmianę tekstu w tym wierszu.

    1. Na pasku narzędzi komentarza wybierz ikonę +- (prawdopodobnie ikona najdalej po lewej stronie). Jest to przycisk Wstaw sugestię.

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

    2. Tekst z wybranego wiersza zostanie uwzględniony w bloku kodu (wewnątrz dwóch zestawów "" backticksów).

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

      Aby zasugerować zmiany tekstu zawierającego potrójne ogrodzenie kodu (''),zastąp zewnętrzne/otaczające suggestion backticks tyldami (~~~).

    3. Edytuj tekst. Użyj przycisków w polu komentarza w celu prostego formatowania, takiego jak pogrubienie, kursywa i punktory, lub użyj bezpośrednio elementów składni języka Markdown. Możesz również dodać komentarze do tego pola poniżej sekcji bloku kodu.

  6. Po dokonaniu komentarza wybierz pozycję Rozpocznij przegląd. Autor żądania ściągnięcia zostanie powiadomiony o zmianach. Jeśli w poprzednim kroku użyto przycisku Wstaw sugestię , autor będzie mógł zatwierdzić sugestię bezpośrednio w dokumencie.

    Jeśli chcesz przenieść inną osobę do konwersacji, możesz @mention innych współautorów za pomocą aliasu usługi GitHub w komentarzach. Wymienieni użytkownicy usługi GitHub otrzymają wiadomość e-mail zawierającą Twój komentarz. Możesz również użyć języka Markdown w komentarzach, a znacznik Markdown komentarza jest renderowany po przesłaniu komentarza.

  7. Na karcie Konwersacje przeczytaj komentarze. Jeśli masz pytania lub komentarze, dodaj je do konwersacji. Możesz również dodać reakcje na komentarze, wybierając ikonę buźki w lewym dolnym rogu każdego komentarza.

Przesyłanie przeglądu

Po dodaniu wszystkich komentarzy do przeglądu prześlij recenzję.

  1. Wybierz przycisk Przejrzyj zmiany w prawym górnym rogu karty Pliki zmienione, aby otworzyć okno dialogowe przesyłania przeglądu.
  2. Wprowadź opisowe podsumowanie przeglądu.
  3. Wybierz przycisk radiowy dla żądanego typu recenzji, a następnie wybierz pozycję Prześlij recenzję.

Submitting a review in GitHub.

Autor żądania ściągnięcia otrzyma powiadomienie o przeglądzie.

Następne kroki

Aby dowiedzieć się więcej na temat komentowania i recenzji, zapoznaj się z tymi artykułami w dokumentacji usługi GitHub.