Английский Git и code review

Тема дорожной карты · Английский для IT

🔊 Словарь терминов с произношением →

Git и code review — та часть работы, где английский нужен даже инженеру в полностью русскоязычной команде: история коммитов, названия веток, шаблоны PR и комментарии в GitHub или GitLab принято вести на английском, потому что репозиторий переживёт команду, а будущие читатели могут не знать русского. Одновременно это самая формализованная часть рабочего английского: у commit messages есть стандарт Conventional Commits, у описаний PR — устоявшаяся структура, у комментариев ревью — сложившийся набор сокращений (nit, LGTM, PTAL) и правил вежливости. Выучить эти конвенции проще, чем свободный разговорный английский, а эффект заметен сразу: аккуратная история коммитов и внятные описания PR читаются как признак зрелого инженера. Раздел разбирает пять тем: как писать commit messages, как описывать PR, какие слова и сокращения используют ревьюеры, как смягчать критику и как называются операции с ветками.

Как произносится

Git /ɡɪt/ («гит», твёрдое «г»), commit /kəˈmɪt/ (ударение на второй слог), pull request /ˌpʊl rɪˈkwɛst/ («пул риквЕст», не «пуш реквест» и не «пул рЕквест»), merge /mɜːrdʒ/, review /rɪˈvjuː/ (ударение на второй слог), reviewer /rɪˈvjuːər/, approve /əˈpruːv/, branch /brɑːntʃ/ или /bræntʃ/, repository /rɪˈpɒzɪtəri/, repo /ˈrɛpoʊ/ («репоу»), diff /dɪf/, conflict как существительное /ˈkɒnflɪkt/, squash /skwɒʃ/, rebase /ˌriːˈbeɪs/, cherry-pick /ˈtʃɛri pɪk/, stash /stæʃ/, blame /bleɪm/, checkout /ˈtʃɛkaʊt/.

Как употребляется

Полный цикл одной задачи на английском:

  • Create a branch: feature/user-export — I branched off master.
  • Commit: feat(export): add CSV export for user list — I committed the first pass.
  • Open a PR: Opened a PR against master, PTAL when you have a minute.
  • Review: LGTM with one nit: could you rename tmp to something descriptive?
  • Address feedback: Addressed all comments, pushed a fixup.
  • Approve and merge: Approved. Squash-merging now.
  • Follow-up: Rebased onto master to resolve the conflict in routes.ts.

Ключевые глаголы: open a PR, request a review, leave a comment, address comments, push a fix, approve, request changes, merge, squash, rebase, resolve a conflict, revert.

Ловушки

Первая ловушка — русский в истории коммитов международного проекта: «поправил баг» через два года прочитает человек без кириллицы на клавиатуре. Вторая — «пуш реквест»: операция называется pull request, потому что автор просит мейнтейнера pull (забрать) изменения; GitLab называет то же merge request. Третья — approve как существительное («дай апрув»): по-английски approval. Четвёртая — прямые повелительные формы в комментариях ревью (Rename this, Fix it): в англоязычной культуре ревью они звучат грубо; принято Could you rename this? или Consider renaming. Пятая — LGTM без чтения кода: аббревиатура означает looks good to me и подразумевает, что вы действительно посмотрели. Шестая — путать merge и rebase при описании: merged master into my branch и rebased my branch onto master — разные операции с разной историей.

Связанные понятия

Полезные ресурсы