Pull requesty

Pull request proponuje scalenie zmian z jednej gałęzi do innej — zwykle domyślnej — i daje zespołowi miejsce do ich przejrzenia, omówienia i zatwierdzenia przed scaleniem.

Odejdź od linii domyślnej, zatwierdź swoją pracę w commitach, otwórz pull request do recenzji, a następnie scal z powrotem — jako commit scalający, squash lub rebase. Po zakończeniu usuń gałąź.

Tworzenie gałęzi

Pracuj na nowej gałęzi, aby zmiany pozostały oddzielone od gałęzi domyślnej, dopóki nie będą gotowe.

W interfejsie:

Otwórz repozytorium i wybierz selektor gałęzi w lewym górnym rogu (pokazuje nazwę bieżącej gałęzi).
Wpisz nazwę nowej gałęzi w polu wyszukiwania i wybierz Create Branch.

Lokalnie:

Utwórz gałąź i przełącz się na nią: git checkout -b feature-x
Wprowadź zmiany, a następnie dodaj je do poczekalni i zatwierdź: git add ., a potem git commit -m "Describe what changed"
Wypchnij gałąź do PlaidCloud Git: git push -u origin feature-x

Otwieranie pull requesta

Otwórz repozytorium i wybierz kartę Pull Requests, a następnie New Pull Request.
Ustaw jako gałąź Porównaj swoją gałąź funkcji, a jako gałąź Podstawowy gałąź docelową (zwykle main lub master).
Napisz czytelny tytuł oraz opis wyjaśniający, co się zmieniło i dlaczego.
Aby powiązać pokrewne zgłoszenia, dodaj w opisie słowo kluczowe zamykające — na przykład Closes #12 — dzięki czemu zgłoszenie zamknie się automatycznie po scaleniu pull requesta.
W razie potrzeby przypisz recenzentów, a następnie wybierz Create Pull Request.

Recenzowanie zmian

Recenzenci przeglądają pull request bez scalania czegokolwiek:

Otwórz pull request i wybierz Files Changed, aby przeczytać różnice.
Wybierz dowolny wiersz w różnicach, aby zostawić komentarz w tekście do tej konkretnej zmiany.
Po zakończeniu przekaż ogólną ocenę: Zatwierdź, aby wyrazić zgodę, lub Request Changes, aby najpierw poprosić o poprawki.
Autor wypycha kolejne commity do tej samej gałęzi, aby uwzględnić uwagi — pull request aktualizuje się automatycznie, bez potrzeby otwierania nowego.
Recenzenci oznaczają poszczególne wątki komentarzy jako rozwiązane, gdy każda kwestia zostanie uwzględniona.

Scalanie

Gdy pull request zostanie zatwierdzony:

Wybierz metodę scalania z listy rozwijanej obok przycisku Merge:
- Create a merge commit — zachowuje pełną historię gałęzi dzięki commitowi scalającemu.
- Squash and merge — łączy wszystkie commity z gałęzi w jeden commit w gałęzi docelowej.
- Rebase and merge — odtwarza commity gałęzi w gałęzi docelowej bez commita scalającego.
Wybierz Merge, aby zakończyć.
Opcjonalnie wybierz Delete Branch, aby posprzątać gałąź funkcji, gdy nie jest już potrzebna.