Глава 23 · Часть II · Планируем SafeSort на GitHub
Глава 23 · Часть II · Планируем SafeSort на GitHubЧерновики: задача без Issue
Черновик (draft issue) фиксирует мысль внутри Project раньше, чем она станет формальным Issue репозитория.
SafeSort · Часть 2 из 6Планирование
Не каждая мысль о будущей задаче сразу дозревает до полноценного Issue с Problem, Expected outcome и чек-листом Acceptance criteria. Для таких промежуточных заметок у Project есть черновик (draft issue) — элемент с заголовком и текстом, который существует только внутри Project и пока не связан ни с одним репозиторием.
| Issue | Черновик (draft issue) |
|---|---|
| живёт в конкретном репозитории | живёт только внутри Project |
| у него есть номер (#14 и т.д.) | номера нет — это ещё не запись репозитория |
| виден в списке Issues репозитория | виден только тем, у кого есть доступ к Project |
| можно связать Pull Request через «Closes #N» | связать Pull Request нельзя, пока не станет Issue |
У SafeSort черновиков не было — но приём стоит знать
Все 14 задач SafeSort с самого начала были сформулированы достаточно чётко, чтобы сразу стать полноценными Issues (следующие разделы), — черновики в их истории не использовались. Но приём полезен в проектах, где работа идёт не заранее спланированным списком, а по ходу дела: увидели проблему во время разработки — сразу записали черновиком в Project, не отвлекаясь на формулировку полноценного Issue.
Официальная документация
Перевод и учебная адаптация официальной документации GitHub. Исходный материал — CC BY 4.0.
Коротко
- Черновик (draft issue) — элемент Project без репозитория и без номера, для мыслей, которые ещё не дозрели до Issue.
- У черновика есть заголовок, текст и статус, но нет связи с Pull Request.
- SafeSort обошёлся без черновиков, потому что все 14 задач были сформулированы сразу как Issues.