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.
| Issue | Draft (draft issue) |
|---|---|
| żyje w konkretnym repozytorium | istnieje tylko wewnątrz Project |
| ma numer (#14 itd.) | brak numeru — to jeszcze nie jest zapis w repozytorium |
| jest widoczny na liście Issues repozytorium | jest 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 |
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
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.