Черновой pull request: показать работу рано

Черновой pull request (draft) - это тот же pull request, но помеченный как ещё не готовый к слиянию. Кнопку слияния GitHub на нём блокирует, а тебе это даёт способ показать направление, пока работа не дописана.

Зачем открывать рано

Смысл черновика - собрать обратную связь по подходу раньше, чем ты потратил на него день. У тебя есть каркас, первая миграция, набросок интерфейса - открываешь черновик, и коллега успевает сказать «не та таблица» до того, как ты построил на ней ещё двенадцать файлов. Без черновика выбор беднее: либо молчать сутки в своей ветке, либо открыть обычный pull request и позвать людей на полуготовое. Готовый pull request просят прочитать целиком; черновик говорит «посмотри, туда ли я иду», и это разные просьбы.

Как открыть черновиком

Ветку отправляешь на сервер как обычно, разницы в git нет. Черновик выбирается на сайте: у кнопки Create pull request есть выпадающий список, в нём - Create draft pull request. Из терминала то же самое делает GitHub CLI:

$ gh pr create --draft

На странице появляется серая плашка Draft, а кнопка слияния остаётся неактивной.

Что при этом меняется

Обязательных ревьюеров (тех, что назначает CODEOWNERS или branch protection) черновик не дёргает: GitHub не запрашивает у них ревью и не шлёт уведомление, пока pull request в черновом состоянии. Формальное ревью не тратится на полуфабрикат, а коллеге не приходит письмо «проверь меня» на код, который завтра перепишут.

Читать и комментировать черновик при этом никто не мешает. Diff открыт, построчные замечания оставляются как в любом pull request - разница лишь в том, что ревью не запрошено официально и слияние заблокировано.

Автоматика обычно работает как всегда: сборка и тесты прогоняются на каждый коммит, и ты видишь зелёное или красное по ходу дела. Отключить это можно только явно, когда workflow настроен запускаться лишь на готовых pull request (событие ready_for_review).

Как перевести в готовый

Когда работа дописана, на странице есть кнопка Ready for review, из терминала - gh pr ready. В этот момент GitHub запрашивает ревью у обязательных ревьюеров и снимает блокировку со слияния. Обратный ход тоже есть: готовый pull request можно вернуть в черновик кнопкой Convert to draft.

Частые ошибки

Черновик - не приватный. Все, у кого есть доступ к репозиторию, его видят; это способ пометить готовность, а не спрятать код от чужих глаз.

Черновик, забытый в черновом состоянии, не дождётся ревью. Ревьюеров ничто не позвало, они ждут сигнала, которого нет. Дописал - переведи в Ready for review, иначе законченная работа так и висит без единого замечания.

Где это в учебнике

Глава 7. Как git используют в командах. Что такое pull request целиком - в статье pull request.