Англійська для віддаленого асинхронного зв' язку

Віддалена робота працює на письмовій англійській. В офисе можно обернуться и задать вопрос. У розподіленій команді кожна взаємодія є повідомленням — гілка Slack, коментар запитів на витягування, письмове оновлення стану, записане рішення. Якість вашої письмової англійської мови безпосередньо визначає ефективність вашого співробітництва з віддаленою командою.

У цьому підручнику описано особливі шаблони запису, які роблять віддалене асинхронне обмін повідомленнями чітким, ефективним і професійним.

---

Для оцінки точності оцінки використовується асинхронний метод

У синхронній розмові ви можете негайно прояснити, якщо щось не розумієте. В асинхронному контексті, погано написане повідомлення може залишатися на годину, перш ніж хтось його прочитає, а потім вимагає подальшого питання, яке залишається ще кілька годин, перш ніж прийде відповідь. Одне неоднозначне речення може коштувати півдня.

Ось чому асинхронне обмін повідомленнями вимагає від вас передбачення нерозумінь і їх виключення перед натисненням кнопки надсилання. Мета — це повідомлення, яке не потребує подальшого питання.

---

Запис повідомлень Slack

Начнем с самого низа

У асинхронному обміні даними користувачеві не слід прокручувати до кінця, щоб зрозуміти, що ви хочете сказати. У першому реченні вкажіть ключову думку або запит.

** Слабкий: ** * “Гей, я дивився на службу автентифікації і помітив деякі речі. Останнім часом він поводиться дивно, і я копаюся в журналах. Тому я задумався, чи може нам варто подивитися на логіку оновлення знаків, тому що я думаю, що там може бути проблема.”*

** Strong: ** * “Я вважаю, що у логіці оновлення токенів у службі автентифікації є помилка. Користувачі, яких це стосується, отримують 401 через 30 хвилин. Я долучив відповідні журнали. @nina можеш подивитися?”*

Сильна версія говорить про проблему, вплив, докази і наступну дію - все в трьох реченнях.

Включити контекст

Асинхронні читачі не мають такого ж фону, як і ви. Завжди відповідайте: про що це, чому це важливо, і що вам потрібно?

** Ключові фрази для надання контексту: **

• “Для контексту,…”
• • “Тло: ми перебуваємо у процесі переходу на новий провайдер автентифікації.” *
• • “Це пов’ язано з гіллям з вівторка про тайм- аути сеансів.” *
• “Я поднимал этот вопрос здесь, потому что это блокирует выход, запланированный на четверг.”

Будь ясно про наступні кроки

У кожному асинхронному повідомленні має бути чітко вказано, що ви очікуєте побачити далі. Це тільки для інформації? Вам нужно решение? Ти просиш когось зробити щось?

• “Не потрібно робити нічого — просто попередити.”
• “Мені потрібно рішення щодо цього до четвер, щоб ми могли оновити план випуску.”
• “Чи не могли б ви переглянути цей PR, коли у вас буде можливість? Не поспішай, але я б хотів отримати відгук до кінця тижня».
• “Я буду двигаться вперед с вариантом А, если только завтра не услышу возражений от ОВБ.”

Ця остання фраза — “Я продовжу, якщо не почую заперечень” — є потужним асинхронним шаблоном. За допомогою цього пункту можна створити типову дію і визначити чіткий термін виконання введення даних, не вимагаючи від кожного з учасників явного підписання.

---

Запис асинхронних оновлень стану

Оновлення стану підтримують розподілені команди в єдиній лінії без необхідності зустрічей. Найбільш поширеним форматом є тричастинне оновлення: що я зробив, що я роблю, будь-які блоки.

Ключові фрази для оновлень стану

Що я завершив:

• • “Я відправив інтеграцію функціонального прапора для потоку впровадження.” *
• “Завершено обзор кода для платежного модуля PRs.”
• • “Завершено скриптом міграції бази даних і запущено його проти перевірки.” *

Над чем я работаю:

• “Поки що працюємо над програмою обмеження швидкості API.”
• • “Під час зневадження виникла неодноразова помилка тестування в CI — це перегони в налаштуванні тестування.” *
• “Створення RFC для пропозиції щодо стандартизації ведення журналів.”

Блокери

• • “Блокування на підтвердження командою інфраструктури нової ролі IAM.” *
• “Ожидается разъяснение по поводу продукта в случае с квитком ENG-441.”
• “Без блокаторов.”

Писання рішень асинхронно

В асинхронних командах рішення повинні бути записані письмово, з їх обґрунтуванням. Рішення, прийняте в гілки Slack, яке ніхто не може знайти через три місяці, фактично втрачено.

** Шаблон для написання рішення: **

Рішення: Що було вирішено ** Контекст: ** Чому це рішення було необхідним ** Розглянуті варіанти:** Короткий опис альтернатив ** Причина: ** Чому було обрано цей параметр ** Власник: ** Хто відповідає за виконання ** Дата: ** Коли було прийнято рішення

Запис у такому форматі займає додаткові п’ ять хвилин і позбавляє вас годин збою пізніше.

---

Записання хороших описів запитів на завантаження

Запит на завантаження є артефактом асинхронного зв’ язку. Опис PR — це ваша можливість пояснити вашу зміну рецензенту, який не був у вашій голові, коли ви писали код.

Основні розділи для опису PR

** Що робить ця публікація? ** Ясне, одноабзацеве резюме зміни.

** Чому було внесено цю зміну? ** Посилання на квиток, RFC або розмову, яка мотивувала його. * « Це реалізує обмеження швидкості, обговорене у RFC- 47. » *

** Як це було перевірено? ** * “Я перевірив це вручну проти середовища тестування і додав тести одиниць для краєвих випадків.” *

** Примітки для переглядача: ** * “Головна складність полягає у tokenRefreshHandler. Решта — звичайна риба»

** Знімок екрана або запис** змін у інтерфейсі користувача — вставте зображення або посилання на запис Loom.

Ключові фрази для коментарів PR

Під час перегляду:

• • « Nit: назва цієї змінної може бути більш описовою. » * (Nit = nitpick, необов’ язкова невелика пропозиція)
• • “Блокування: це призведе до виключення нульового вказівника, якщо userId не визначено.” *
• • “Питання: чи є причина, чому ми не використовуємо існуючий допоміжний інструмент validateUser?” *
• “Це елегантно — гарне рішення.”

Під час відповіді на коментарі перегляду:

• • « Добрий вилов — виправлено у останньому звіті. » *
• *“Я так і залишив, бо [причина]. Щасливий змінюватися, якщо ти сильно відчуваєш»
• “Договорились. Обновлено.”

---

Тона в асинхронному записі

Без голосового тону, виразу обличчя або мови тіла текст може читатися холодніше або різкіше, ніж це було заплановано. Декілька порад допоможуть:

** Використовуйте м’якші форми для запитів: ** “Чи могли б ви…” замість “Зробіть це.”

Підтвердження перед перенаправленням: “Готовий аргумент — я також додав би, що…” замість того, щоб перейти прямо до вашого контр-аргументу.

** Сигнал, коли щось не є невідкладним: ** * « Не поспішай » * або * « коли з’ явиться можливість » * знімає тиск і допомагає колегам визначити пріоритети власної роботи.

** Не пишіть з великими літерами, щоб підкреслити. ** Це звучить як крики. Використовувати курсив або жирний шрифт.

---

Ключовий словник

• ** Асинхронний ** — асинхронний; обмін даними, який не вимагає присутності обох сторін у той же час
• ** EOD / EOW ** — кінець дня / кінець тижня; спільні позначки терміну виконання у віддалених командах
• ** Блокер ** — щось, що перешкоджає прогресу, що вимагає введення або дії від іншої людини
• ** Nit ** — незначна, необмежена пропозиція у перегляді коду
• LGTM — «Виглядає добре для мене»; звичайний сигнал схвалення у перегляді запитів на звантаження
• ** FYI ** — « Для вашої інформації »; використовується, коли спільно використовується щось, що не вимагає жодних дій
• ** Heads up ** — неформальна попередня інформація про щось важливе
• ** Потрібна дія ** — сигналізує, що адресат має виконати певну дію до кінця терміну

---

Хороші навички асинхронного письма розвиваються з часом. Кожне ясне повідомлення створює слід документованих рішень, спільного контексту і історії пошуку. Команди, які добре пишуть асинхронно, рухаються швидше, ніж команди, які компенсують це більшою кількістю зустрічей — і вони роблять це в кожному часовому поясі.