Rozdział 23 · Część II · Planowanie SafeSort na GitHub

Szkice: Zadanie bez Issue

Szkic (draft issue) uchwyca myśl w Project zanim stanie się formalnym repozytorium Issue.

SafeSort · Część 2 z 6Planowanie

Nie każda myśl o przyszłym zadaniu od razu dojrzewa do pełnoprawnego Issue z Problem, Expected outcome i lista kontrolna Acceptance criteria. Do takich notatek średniozaawansowanych Project draft (draft issue) to element z tytułem i tekstem, który istnieje tylko w Project i nie jest jeszcze powiązany z żadnym repozytorium.

IssueDraft (draft issue)
żyje w konkretnym repozytoriumistnieje tylko wewnątrz Project
ma numer (#14 itd.)brak numeru — to jeszcze nie jest zapis w repozytorium
jest widoczny na liście Issues repozytoriumjest widoczny tylko dla tych, którzy mają dostęp do Project
można powiązać z Pull Request za pomocą „Closes #N”powiązać Pull Request nie można, dopóki nie stanie się Issue
Ideakrótko zapisanebezpośrednio w ProjectDraftnagłówek i tekst,status można zmieniaćjak każdy żywiołDojrzałem do zadanianastępna część —przemiana wprawdziwa Issue
Szkic — sposób na utrwalenie myśli w Project zanim stanie się ona formalnym Issue
SafeSort nie miał roboczych wersji — ale warto znać metodę
Wszystkie 14 zadań SafeSort zostało sformułowanych na tyle jasno od samego początku, by od razu stać się pełnoprawnym Issues (poniższe sekcje) — szkice nie były używane w ich historii. Technika ta jest jednak przydatna w projektach, gdzie praca nie jest wykonywana na wstępnie zaplanowanej liście, lecz w trakcie procesu: jeśli podczas tworzenia zauważysz problem, natychmiast zapisujesz szkic w Project, nie rozpraszając się formułowaniem pełnoprawnego Issue.
Oficjalna dokumentacja
Adding items to your project
Tłumaczenie i edukacyjna adaptacja oficjalnej dokumentacji GitHub. materiałów źródłowych – CC BY 4.0.

Krótko

  • Draft (draft issue) to element Project bez repozytorium i bez numeru, dla myśli, które jeszcze nie są gotowe do Issue.
  • Szkic ma tytuł, tekst i status, ale nie ma linku do Pull Request.
  • SafeSort nie miał wersji roboczej, ponieważ wszystkie 14 zadań zostało sformułowanych natychmiast jako Issues.