Pull request (PR) to propozycja włączenia zmian z jednej gałęzi do drugiej, zgłaszana w serwisie takim jak GitHub, GitLab czy Bitbucket. Wokół niej odbywa się przegląd kodu: współpracownicy komentują zmiany, sugerują poprawki i zatwierdzają scalenie. W GitLabie odpowiednik nazywa się merge request.
Jak wygląda pull request?
Autor zakłada gałąź, zapisuje commity i otwiera PR z opisem celu zmian. Platforma pokazuje różnice w plikach, wyniki testów automatycznych i miejsce na komentarze. Po zatwierdzeniu przez wymaganą liczbę osób zmiany scala się z gałęzią docelową.
Dobre praktyki
Małe PR są łatwiejsze do przeglądu niż duże. Opis powinien wyjaśniać, co zmieniono, dlaczego i jak to sprawdzić. Przed zgłoszeniem warto samodzielnie przejrzeć różnice i upewnić się, że testy przechodzą.
PR a kontrola jakości
Zasady ochrony gałęzi pozwalają wymusić przegląd i pozytywny wynik testów przed scaleniem. To podstawowy mechanizm dbania o jakość kodu w zespole, także w projektach open source, gdzie PR jest zwykle jedynym sposobem wniesienia wkładu.