Propozycje scalenia
Poproś o sprawdzenie zmian w gałęzi, zanim trafią do innej gałęzi.
Omówienie
Propozycja scalenia rejestruje prośbę o scalenie zmian z jednej gałęzi do drugiej i pozwala członkowi zespołu przejrzeć różnice przed scaleniem. Każdy z uprawnieniami do edycji agenta może otworzyć propozycję, nawet dla gałęzi, do której sam nie może scalać zmian. Scalenie propozycji nadal wymaga uprawnień do zapisu w gałęzi docelowej, więc dzięki propozycji zmiana może trafić do chronionej gałęzi bez nadawania każdemu współtwórcy prawa do scalania.
Propozycje scalenia dodają opcjonalny etap przeglądu do bezpośredniego scalania gałęzi. Scalaj bezpośrednio, gdy masz dostęp do zapisu w gałęzi docelowej i nie potrzebujesz drugiej opinii. Otwórz propozycję, gdy chcesz najpierw uzyskać przegląd albo gdy gałąź docelowa jest chroniona i nie masz do niej dostępu do zapisu.
Dostępność
Propozycje scalenia są w fazie alfa. Gdy jednocześnie rozwijanych jest kilka gałęzi agenta, trudno śledzić, które są gotowe i bezpieczne do scalenia. Propozycje scalenia dają zespołowi jedno miejsce do przeglądu i omawiania zmian w gałęzi, porównywania wyników testów między gałęziami oraz sprawdzania najnowszych rozmów z gałęzi.
Faza alfa to pierwszy krok w stronę workflow dla agentów w stylu CI/CD, podobnego do pull requestów na GitHubie. Planowane dodatki w nadchodzących tygodniach obejmują:
- Wymagane testy, które muszą przejść przed scaleniem propozycji.
- Prośby o zatwierdzenie od konkretnych recenzentów.
- Konfigurację właścicieli różnych części agenta.
Cykl życia propozycji
Każda propozycja ma jeden z tych statusów:
Gdy propozycja jest otwarta, recenzenci mogą wydać jeden z tych werdyktów. Najnowszy werdykt recenzenta zastępuje każdy wcześniejszy werdykt tego samego recenzenta:
Otwieranie propozycji
Otwórz propozycję z gałęzi, której zmiany chcesz poddać przeglądowi:
Z listy gałęzi
Z karty Propozycje
Na karcie Gałęzie agenta otwórz menu opcji gałęzi źródłowej i wybierz **Otwórz propozycję scalenia **.
Nadaj propozycji tytuł, opcjonalny opis i wybierz gałąź docelową spośród pozostałych niezarchiwizowanych gałęzi agenta. Otwarcie propozycji nie zmienia żadnej z gałęzi — tylko rejestruje prośbę.
Para gałęzi źródłowej i docelowej może mieć jednocześnie najwyżej jedną otwartą propozycję. Zamknij istniejącą przed otwarciem kolejnej między tymi samymi dwiema gałęziami.
Przeglądanie propozycji
Strona propozycji ma te karty:
Omówienie
Zmiany
Uruchomienia testów
Rozmowy
Opis, historia przeglądów i formularz do zostawienia przeglądu.
Każdy z uprawnieniami do edycji agenta, poza autorem propozycji, może zostawić przegląd z opcjonalnym komentarzem. Komentarze obsługują Markdown.
Scalanie propozycji
Scalenie propozycji wykonuje to samo scalanie gałęzi, co scalanie bezpośrednie, w tym rozwiązywanie konfliktów oraz opcję późniejszego archiwizowania gałęzi źródłowej. Przed scaleniem propozycja musi spełniać te wymagania:
- Użytkownik scalający ma dostęp do zapisu w gałęziach źródłowej i docelowej. W przypadku chronionej gałęzi oznacza to bycie administratorem workspace’u.
- Najnowszy werdykt żadnego recenzenta nie brzmi „poproszono o zmiany”. Recenzent, który poprosił o zmiany, musi zatwierdzić propozycję przed jej scaleniem.
- Propozycja ma co najmniej jedno zatwierdzenie od osoby innej niż jej autor. Administratorzy workspace’u mogą scalać bez tego zatwierdzenia.
Scalenie propozycji automatycznie zamyka każdą inną otwartą propozycję dla tej samej gałęzi źródłowej, ponieważ jej zmiany zostały już przeniesione.
Zamykanie propozycji
Propozycję można zamknąć bez scalania w dowolnym momencie, gdy jest otwarta. Autor i recenzenci mogą edytować jej tytuł oraz opis, dopóki nie zostanie zamknięta.
- Gdy autor zamyka własną propozycję, zostaje ona oznaczona jako wycofana.
- Gdy zamyka ją ktoś inny, zostaje oznaczona jako odrzucona.
- Zarchiwizowanie gałęzi źródłowej automatycznie zamyka każdą otwartą propozycję z niej lub do niej, oznaczoną jako branch_archived.
Propozycje scalenia i Architect
Architect ma dostęp do odczytu gałęzi agenta, gdy pytasz go o gałęzie, wersje i scalenia, więc może pomóc ci zrozumieć różnice w propozycji lub podsumować otwarte przeglądy w rozmowie.