Żądanie ściągnięcia (PR) to funkcja GitHub, która umożliwia proponowanie zmian w repozytorium, do którego nie masz uprawnień do zapisu. Opiekunowie repozytorium mogą przeglądać te zmiany i, jeśli zechcą, scalać je z oryginalnym repozytorium.
Otwieranie żądań ściągnięcia w GitHub ma kluczowe znaczenie dla udziału w projektach open source i współpracy z innymi programistami. Dowiedz się, jak utworzyć i otworzyć żądanie ściągnięcia w serwisie GitHub w zaledwie kilku prostych krokach.
Krok 1: Rozwidlenie repozytorium
Rozwidlanie repozytorium na platformę GitHub tworzy kopię — zwaną inaczej „forkiem” — tego repozytorium na Twoim koncie. Rozwidlenie repozytorium umożliwia wprowadzanie zmian w kodzie bez wpływu na oryginalne repozytorium.
Aby rozwidlić repozytorium, przejdź do jego strony głównej i kliknij przycisk widelec przycisk w prawym górnym rogu:
Wpisz nazwę repozytorium (fork) oraz opcjonalny opis i kliknij Utwórz widelec:
Teraz utworzyłeś kopię oryginalnego repozytorium. To nowe repozytorium ma połączenie z oryginałem, dzięki czemu wszelkie zmiany wprowadzone w kodzie można łatwo porównać i scalić z powrotem.
Krok 2: Wprowadzanie zmian w kodzie
Po rozwidleniu repozytorium może być konieczne sklonowanie go na lokalną maszynę, w zależności od ilości i charakteru zmian, które chcesz zaproponować. Jeśli wprowadzasz bardzo proste zmiany, których nie musisz testować, możesz to zrobić online za pomocą edytor internetowy GitHub.
Aby sklonować repozytorium na maszynę lokalną za pomocą Git, uruchom to polecenie terminala:
git klon
Zastępować z adresem URL twojego repozytorium — możesz to znaleźć na GitHub. To polecenie sklonuje repozytorium na lokalną maszynę, gdzie możesz swobodnie eksperymentować i wprowadzać zmiany w kodzie.
Zmiany powinny być małe i skoncentrowane, ponieważ przeglądanie i scalanie dużych żądań ściągnięcia może być trudne. Staraj się, aby zmiany były specyficzne dla jednego problemu lub funkcji, aby ułatwić opiekunom ich przejrzenie i zaakceptowanie.
Po wprowadzeniu żądanych zmian lokalnie zatwierdź je i wypchnij do forka GitHub przy użyciu Gita.
Krok 3: Otwarcie żądania ściągnięcia
Po zatwierdzeniu zmian w GitHub powinieneś zobaczyć monit ostrzegający, że twoja gałąź jest o kilka „zatwierdzeń” przed repozytorium, z którego ją rozwidlałeś, na przykład:
Kliknij Brać w czymś udział upuścić. Kliknięcie tego przycisku spowoduje wyświetlenie monitu o otwarcie żądania ściągnięcia. Następnie kliknij Otwórz żądanie ściągnięcia przycisk:
Niektóre repozytoria mają określone wytyczne dotyczące wkładu, które zazwyczaj można znaleźć w pliku CONTRIBUTING.md, których należy przestrzegać. Przed przesłaniem żądania ściągnięcia przeczytaj i postępuj zgodnie z tymi wskazówkami.
Następnie wypełnij wymagane pola i kliknij przycisk Utwórz żądanie ściągnięcia przycisk:
Twoja wiadomość o zatwierdzeniu powinna być jasna i zwięzła, opisując wprowadzone zmiany i ich uzasadnienie. Pomoże to opiekunom zrozumieć zmiany i ułatwi im przeglądanie kodu.
Po utworzeniu ściągi musisz poczekać, aż opiekunowie projektu przejrzą ją i połączą lub zamkną. Opiekunowie mogą mieć sugestie lub opinie na temat twojego żądania ściągnięcia. Bądź otwarty na zmiany i chętny do wprowadzania poprawek, jeśli cię o to poproszą.
Znaczenie żądań ściągnięcia
Żądania ściągnięcia ułatwiają współpracę między programistami, umożliwiając im proponowanie zmian, przekazywanie opinii i przeglądanie kodu. Pomaga to budować poczucie wspólnoty i współpracy w ramach projektu, co prowadzi do większej liczby wkładów i szybszego rozwoju.
Ponadto żądania ściągnięcia porządkują historię projektu i wersjonowanie, umożliwiając opiekunom śledzenie różnych wersji kodu i zmian wprowadzonych w każdej wersji.
