Англійська для code review: як писати коментарі й приймати критику
Той самий технічний зміст коментаря може прозвучати як порада колеги або як ляпас, і вирішує це не код, а формулювання. Розробник із сильною технічною англійською нерідко спотикається саме на рев'ю: написати This is wrong легко, а от так, щоб автор не образився й виправив охоче, уже складніше. У розподілених командах, де половина учасників не носії мови, ця навичка цінується не менше за вміння читати чужий код.
Лексика рев'ю вузька й передбачувана, тому її реально натренувати окремо. Робочу мову розробника під щоденні задачі добре ставить англійська для розробників, де акцент саме на тому, як пояснювати рішення й давати фідбек, а не на абстрактній граматиці.
Чому тон коментаря важить більше за зміст
Текстовий коментар позбавлений інтонації й міміки, тому читач домальовує тон сам. Суха фраза Don't do this в усному форматі прозвучала б нейтрально, а в пул-реквесті легко читається як докір. Звідси правило, яке діє в усіх здорових командах: критикуємо код, а не людину, і пропонуємо, а не наказуємо. Англійська має для цього готовий набір помʼякшувачів, які перетворюють вимогу на прохання.
| Різко | Мʼякше | Чому краще |
|---|---|---|
| This is wrong | I think this might break when the list is empty | називає проблему, а не вирок |
| Don't do this | Could we avoid this here? It might cause a race condition | пояснює причину |
| Why did you do this? | What's the reasoning behind this approach? | питає, а не звинувачує |
| Rewrite this | Would it be cleaner to extract this into a helper? | лишає автору вибір |
| Bad name | A clearer name might help future readers | про користь, не про провину |
Conventional Comments: префікси, що економлять нерви
Велика частина непорозумінь на рев'ю виникає тому, що автор не розуміє ваги коментаря: дрібна вподобайка це чи блокер, який не дасть змерджити. Розвʼязує проблему проста угода Conventional Comments: кожен коментар починається з мітки, яка одразу задає його статус. Команда читає такі коментарі швидше, бо бачить пріоритет ще до тексту.
| Мітка | Значення | Приклад |
|---|---|---|
| praise: | похвала, що варто зберегти | praise: clean and readable solution |
| nitpick: | дрібниця, не блокер | nitpick: extra blank line here |
| suggestion: | пропозиція покращення | suggestion: we could memoize this |
| issue: | проблема, яку треба виправити | issue: this crashes on null input |
| question: | питання, а не вимога | question: why a map and not a set? |
Фрази для типових ситуацій рев'ю
Більшість коментарів зводиться до чотирьох намірів: похвалити, запропонувати, запитати й вказати на ризик. Для кожного є природні звороти, які звучать по-командному, а не наказово.
Як приймати критику свого коду
Друга половина рев'ю, це відповіді на чужі коментарі, і тут теж є усталені фрази. Парадоксально, але саме коротка ввічлива реакція найбільше впливає на репутацію в команді: вона показує, що Ви відкриті до фідбеку, а не захищаєте кожен рядок.
| Фраза | Переклад | Коли вживати |
|---|---|---|
| Good catch, fixed | слушно, виправив | погодилися з правкою |
| Done | зроблено | коротко закрити коментар |
| LGTM | усе добре, апрув (looks good to me) | схвалити пул-реквест |
| I'd rather keep it as is because… | лишив би як є, бо… | обґрунтована незгода |
| Could you clarify what you mean? | уточни, будь ласка | незрозумілий коментар |
Незгода теж нормальна частина процесу, головне аргументувати, а не відмахуватися. Замість сухого No поясніть позицію: I see your point, but this way we avoid an extra query. Така відповідь лишає дискусію професійною.
Чек-лист перед тим, як натиснути Comment
Перш ніж відправити коментар, пробіжіться поглядом по кількох пунктах. За тиждень вони стануть звичкою, і рев'ю-англійська перестане забирати зайві хвилини.
- Чи критикуєте Ви код, а не автора (this code замість you)
- Чи зрозуміла вага коментаря: nit, suggestion чи issue
- Чи є коротке пояснення «чому», а не лише «що не так»
- Чи лишили Ви автору вибір там, де це питання смаку
- Чи знайшлося хоч одне praise на вдалі рішення
Технічну частину Ви вже знаєте краще за будь-який підручник, лишається відшліфувати мову навколо неї. Поглибити окремі навички допоможуть статті про робочий чат англійською та англійську для співбесіди в Big Tech, де та сама ввічлива стислість працює на Вас.