Zgłoszenia

Zgłoszenia dają zespołowi wspólne miejsce do śledzenia błędów, planowania funkcji i zapisywania wszystkiego, co wymaga uwagi — a wszystko to jest powiązane bezpośrednio z kodem w repozytorium.

Tworzenie zgłoszenia

Otwórz repozytorium i wybierz kartę Issues.
Wybierz New Issue.
Wpisz zwięzły Tytuł opisujący problem lub zadanie.
Napisz Opis w Markdown — w razie potrzeby dołącz kroki reprodukcji, kryteria akceptacji, zrzuty ekranu lub bloki kodu.
Wybierz Submit New Issue, aby je opublikować.

Porządkowanie za pomocą etykiet i kamieni milowych

Etykiety kategoryzują zgłoszenia i ustalają ich priorytety. Zastosuj jedną lub więcej etykiet z prawego paska bocznego podczas wyświetlania zgłoszenia albo bezpośrednio z listy zgłoszeń za pomocą filtru Etykieta. Typowe konwencje to etykiety typu (bug, enhancement) obok etykiet priorytetu (high, low), ale w Issues → Labels możesz utworzyć dowolne etykiety pasujące do Twojego przepływu pracy.

Kamienie milowe grupują zgłoszenia wokół wspólnego celu — daty wydania, sprintu lub celu funkcjonalnego. Utwórz kamienie milowe w Issues → Milestones, a następnie przypisz zgłoszenie do kamienia milowego z jego paska bocznego. Widok kamienia milowego pokazuje postęp w miarę zamykania zgłoszeń.

Przypisywanie i dyskusja

Osoby przypisane — użyj pola Assignees na pasku bocznym, aby wskazać, kto jest odpowiedzialny. Przypisać można dowolnego członka obszaru roboczego z dostępem do repozytorium.
Komentarze — dodawaj kontekst, decyzje lub aktualizacje stanu w wątku komentarzy pod opisem zgłoszenia.
@wzmianki — wpisz @username w dowolnym miejscu komentarza lub opisu, aby bezpośrednio powiadomić daną osobę.
Reakcje — używaj reakcji emoji na komentarze, aby potwierdzić jakiś punkt bez dodawania odpowiedzi.

Powiązanie zgłoszeń z kodem

Odwoływanie się do zgłoszeń w commitach i pull requestach zapewnia identyfikowalność historii.

Odwołanie według numeru — wpisz #12 w komunikacie commita, opisie pull requesta lub komentarzu, aby utworzyć klikalne łącze do zgłoszenia 12 w tym samym repozytorium.
Automatyczne zamykanie po scaleniu — dodaj słowo kluczowe zamykające w opisie pull requesta (na przykład Closes #12, Fixes #34 lub Resolves #56). Gdy pull request zostanie scalony z gałęzią domyślną, wskazane zgłoszenia zamykają się automatycznie.
Odwołania do innych zgłoszeń — używaj #number swobodnie w dowolnym komentarzu zgłoszenia, aby powiązać pokrewne zgłoszenia; każde wskazane zgłoszenie wyświetla łącze zwrotne, więc powiązanie jest widoczne z obu stron.

Wyszukiwanie zgłoszeń

Lista zgłoszeń obsługuje kilka filtrów, które można łączyć:

Filtr	Działanie
Stan	Pokaż zgłoszenia otwarte lub zamknięte
Etykieta	Zawęź do jednej lub więcej etykiet
Kamień milowy	Pokaż zgłoszenia przypisane do kamienia milowego
Osoba przypisana	Pokaż zgłoszenia przypisane do określonej osoby
Autor	Pokaż zgłoszenia otwarte przez określoną osobę

Wybierz odpowiednią kolumnę na pasku filtrów nad listą zgłoszeń, aby zastosować każdy filtr. Informacje o wyszukiwaniu w tytułach i treściach zgłoszeń za pomocą słów kluczowych znajdziesz w Wyszukiwanie kodu.