Письменная коммуникация

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

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

Письменный английский — основной канал общения в распределённых командах: чат, тикеты, письма, документация и архитектурные записки составляют до 80 процентов рабочей коммуникации, а устная речь — остальное. Для русскоязычного инженера письмо одновременно проще устной речи (есть время подумать и проверить) и коварнее: ошибки в артиклях и предлогах видны всем и долго, а тон сообщения без интонации и мимики легко прочитать неверно. Англоязычная письменная культура имеет свои конвенции, которые отличаются от русских: короткие сообщения с TL;DR в начале, вопрос сразу в первом сообщении, а не «привет, есть минутка?», обязательная вежливая рамка (Hi, Thanks, Best) даже в коротком письме, структурированные тикеты по шаблону As a … I want … so that, и документация в повелительном наклонении без пассива. Раздел разбирает пять форматов: асинхронный чат с его сокращениями, тикеты и user stories, деловые письма, README и документацию, архитектурные записки ADR.

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

Written /ˈrɪtn/ («ритн», двойное t произносится как одно, i краткое), communication /kəˌmjuːnɪˈkeɪʃən/, asynchronous /eɪˈsɪŋkrənəs/, async /ˈeɪsɪŋk/ («Эйсинк»), message /ˈmɛsɪdʒ/, thread /θrɛd/ (с «θ»), ticket /ˈtɪkɪt/, user story /ˈjuːzər ˈstɔːri/, email /ˈiːmeɪl/, subject /ˈsʌbdʒɪkt/ (тема письма, ударение на первый слог), recipient /rɪˈsɪpiənt/ («рисИпиент», получатель), attachment /əˈtætʃmənt/, README «рид-ми» /ˈriːdmiː/, documentation /ˌdɒkjʊmɛnˈteɪʃən/, ADR по буквам, architecture /ˈɑːrkɪtɛktʃər/ (ударение на первый слог, «Аркитекчер»), decision /dɪˈsɪʒən/, record /ˈrɛkɔːrd/, tone /toʊn/, register /ˈrɛdʒɪstər/ (стилистический регистр), concise /kənˈsaɪs/ (краткий), verbose /vɜːrˈboʊs/.

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

Один запрос в пяти форматах:

  • Чат: TL;DR: need a review on #412 by EOD, it blocks the release. Details in the PR description.
  • Тикет: As a support agent, I want to export a user's order history to CSV so that I can share it with finance without DB access. Acceptance criteria: …
  • Письмо: Hi Anna, quick heads-up: the export feature ships Friday. Could you loop in finance so they can test on staging Thursday? Thanks, Nikita.
  • README: ## Export. Run make export USER=<id> to generate a CSV in ./out. Requires DB_URL to be set.
  • ADR: Context: finance needs order data without DB access. Decision: build a CSV export endpoint rather than granting read-only DB roles. Consequences: one more endpoint to maintain; no new DB users.

Общие правила: главное в первой строке; один вопрос — одно сообщение; конкретика вместо оценок (by Thursday 5 pm CET вместо ASAP); ссылки вместо пересказа.

Ловушки

Первая ловушка — русская структура письма с преамбулой и вопросом в конце: англоязычный читатель ждёт суть в первых двух строках. Вторая — отсутствие вежливой рамки: сообщение без Hi и Thanks читается как раздражённое. Третья — избыточная формальность из школьных учебников (Dear Sir or Madam, I am writing to inform you): в IT пишут проще. Четвёртая — переносить русскую прямоту (You must fix this): смягчайте так же, как в code review. Пятая — ASAP и urgent без сроков: в англоязычной культуре это раздражает; ставьте дату. Шестая — восклицательные знаки и капс: URGENT!!! воспринимается как крик. Седьмая — писать Colleagues, в начале письма: носители пишут Hi team или Hi all.

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

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