Рев'ю на GitHub - це набір коментарів, які відправляються разом з підсумковим рішенням. Поки рев'ю не відправлене, коментарі видно лише вам.
Три варіанти завершення рев'ю:
| Рішення | Що означає |
|---|---|
| Comment | загальний відгук без схвалення чи блокування |
| Approve | зміни можна вливати |
| Request changes | є проблеми, які треба виправити до злиття |
Якщо в репозиторії налаштовано обов'язкове схвалення, Request changes блокує злиття, доки рецензент не змінить рішення чи рев'ю не відхилять (dismiss).
Коментарі до рядків прив'язуються до конкретного місця дифу - можна виділити кілька рядків і прокоментувати весь фрагмент.
Suggestion - запропонувати готову правку:
```suggestion
$vacancies = Vacancy::query()->with('company')->latest()->paginate(20);
```
Автор бачить диф пропозиції й натискає Commit suggestion - правка стає комітом у гілці PR. Кілька пропозицій можна застосувати одним комітом через Add suggestion to batch.
Коли suggestion доречний: друкарська помилка, перейменування, очевидний однорядковий фікс. Для складніших змін краще пояснити ідею словами - автор знає контекст краще.
Корисні звички:
- збирати коментарі в одне рев'ю (Start a review), а не відправляти по одному - автор отримує одне сповіщення, а не двадцять;
- позначати Viewed переглянуті файли - при оновленні PR GitHub покаже, які з них змінилися;
- Resolve conversation - коли питання закрите; зазвичай це робить той, хто його відкрив, або автор після виправлення;
- повторний запит рев'ю (Re-request review) після виправлень - рецензент отримає сповіщення.
