English Vocabulary for Developer Relations Professionals

Відносини з розробниками (DevRel) є полем на перетині інженерії, маркетингу і створення спільноти. Професіонали DevRel потребують спеціалізованого словника, який охоплює технічну документацію, публічні виступи, управління спільнотою і аналіз даних. Незалежно від того, чи ви тільки починаєте працювати у цій галузі, чи хочете спілкуватися англійською мовою на професійному рівні з вашою командою DevRel, цей запис містить основні слова та фрази, якими ви будете користуватися щодня.

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

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

Техническое евангелизм Більш зовнішня роль зосереджена на просуванні платформи або технології через розмови, демо, блоги і залучення спільноти. Євангельські проповідники будують обізнаність і ентузіазм. Приклад: «Вона дала ключову доповідь на DockerCon — цей вид технічного євангелізму ставить нашу платформу перед десятками тисяч розробників.»

** Подорож розробника ** Повний життєвий цикл залучення розробника до платформи - від першого відкриття, до підписання, до створення свого першого проекту, до того, як він стає потужним користувачем і заступником. Зрозуміти подорож допомагає DevRel команди визначити точки відправлення. Приклад: «Ми розробили карту шляху розробника і виявили великий проміжок часу між реєстрацією і першим успішним викликом API — це наша найбільша точка тертя.»

** Метрики канавки (знання, активація, утримання) ** Ключеві кількісні виміри шляху розробника. Свідомість: скільки розробників знають про те, що ви існуєте. Активація: скільки людей успішно виконали свою першу значущу дію. Утримання: скільки людей продовжують використовувати платформу з часом. Приклад: «Наш рівень активації дуже високий — 70% підписок здійснюють успішний виклик API протягом 24 годин. Але наш 30-денний зберігання становить лише 40%, що говорить нам, що розробники не знаходять довгострокової цінності. ”

** CFP (Заклик до подачі документів / Заклик до подачі пропозицій) ** Відкрите запрошення від конференції для доповідачів надіслати пропозиції щодо доповідей. Команди DevRel надають CFP як частину їх контенту і стратегії спільноти.

• Приклад: « CFP для KubeCon закривається наступної п’ ятниці. Чи є хтось готовий подати пропозицію для обговорення?»*

Метрика здоров’я громади Кількісні показники того, наскільки активна, зацікавлена і зростаюча спільнота розробників — включаючи повідомлення на форумі, зірки GitHub, діяльність Discord, відвідування подій і кількість співробітників. Приклад: “Наші показники здоров’я спільноти зростають - активність форуму зросла на 25% в цьому кварталі і ми досягли 10 000 зірок GitHub.”

Перетвірка Процес збору відгуків розробників, їх пересилання до команд продукту, а потім повідомлення розробникам про зміни, які відбулися у результаті. Закриття петлі — повідомлення розробникам, що їхній зворотній зв’язок був виконаний — є ключовою відповідальністю DevRel.

• Приклад: « Ми закрили цикл зворотнього зв’язку зі спільнотою, опублікувавши запис changelog, пояснюючи, які саме поліпшення API були зроблені на запит користувача. »*

** Дослідження досвіду розробників (DX) ** Структуровані дослідження (інтерв’ю з користувачами, тестування на користувацьку здатність, опитування) спрямовані на розуміння того, як розробники відчувають вашу платформу, документацію та інструменти. Приклад: «Наше дослідження DX показало, що розробники найбільше борються з потоком автентифікації — повідомлення про помилки недостатньо специфічні, щоб допомогти їм зневаджувати.»

** Документація SDK ** Довідкова документація, підручники і приклади коду, які супроводжують набір для розробки програмного забезпечення. Вищокваліфікована документація SDK є критичним продуктом DevRel. Приклад: «Ми переписуємо документацію SDK для клієнта Python — в поточній версії відсутні практичні приклади і є пошкоджені фрагменти коду.»

Фрази і фразеологізми

“Разблокировать разработчиков” Мова DevRel для допомоги розробникам подолати перешкоди — прогалини у документації, заплутані API, відсутні можливості. Розблокування є ключовим значенням DevRel. Приклад: «Це керівництво розроблено для розблокування розробників, які застрягли в налаштуванні OAuth — це постійно найчастіше задаване питання на нашому форумі спільноти.»

“Двигайте прийняття” Мета діяльності DevRel — отримати більше розробників, щоб використовувати і продовжувати використовувати платформу. Приклад: «Наступного місяця ми проводимо хакатон, щоб стимулювати прийняття серед студентів-розробників.»

“Підтвердити CFP” Дія, що передбачає запрошення на виступ на конференції.

• Приклад: « Я надіслав CFP для PyCon щодо використання нашого SDK з асинхронним Python. Я знатиму, якщо це буде прийнято через шість тижнів»

“Закрий петлю зворотнього зв’язку” Дія, яка виконується після того, як спільнота зробила відповідь на їхню заявку. Приклад: «Ми повинні закрити цикл зворотнього зв’язку щодо скарг на обмеження швидкості — інженерна команда відправила виправлення два тижні тому, але ми ще не повідомили спільноту.»

“Культура, в якій розробник на першому місці” Організаційна цінність, яка приоритизує досвід розробника у всіх рішеннях - дизайн API, документація, ціни і підтримка.

• Приклад: « Ми описуємо себе як культуру, де розробники першими, що означає, що документація написана до того, як буде випущено функції. » *

Практичні рекомендації

1. «Наш активаційний воронка показує, що більшість розробників зазнають невдачі на кроці три — отримання їх першої відповіді webhook. Це те, де нам потрібен кращий вчитель»
2. «Я подав три CFP цього сезону — один для місцевої зустрічі, один для регіональної конференції, і один для великого саміту»
3. Наша панель показників здоров’я спільноти показує, що час відповіді на проблеми GitHub в середньому становить 48 годин — це занадто повільно для здорової спільноти розробників
4. «Інтерв’ю з дослідженнями DX показали, що розробники вважають наші повідомлення про помилки занадто загальними — вони не можуть сказати, чи проблема в їх коді або в нашому API»
5. «Ми створюємо публічну дорожню карту, щоб спільнота могла побачити, які з їхніх запитів на функції проходять — саме так ми закриваємо петлю зворотнього зв’язку в масштабі»

Необхідно уникати помилок

Плутанина “заступництва розробників” і “технічного євангелізму” Зазвичай, пропаганда має сильніший внутрішній компонент — пропаганду потреб розробників всередині компанії. Евангелізм - це більш зовнішня реклама. Багато ролей поєднують обидва, але терміни мають різні акценти.

**Позиція DevRel як чисто “маркетингової” ** Професіонали DevRel - це технічні практики. Опис роботи DevRel як маркетингу перед розробниками може підірвати довіру. Використовуйте мову, яка підкреслює технічні та суспільні аспекти.

• Замість: “DevRel - це в основному маркетинг для розробників.” * *Скажіть: “DevRel - це про те, щоб розробники досягли успіху з платформою і перенесли свій досвід назад у продукт.” *

** Відповідає тільки за показники марності ** Учасники конференції або користувачі Твіттера не розповідають повної історії. Прив’ язувати спільну діяльність до метрик льоту. Замість: “Нашу розмову переглянули 5000 разів.” *Скажи: “Наша конференція привела до 200 підписок, 40 з яких завершили активацію за 24 години.” *

Summary

DevRel лексика — подорож розробника, активація метрики, CFP, DX дослідження, зворотній зв’язок петлі — є спільною мовою зростаючої і впливової області. Незалежно від того, створюєте ви документацію, виступаєте на конференціях або керуєте спільними програмами, використання цих термінів точно сигналізує про те, що ви розумієте стратегічний вимір відносин розробників, а не лише поверхню створення контенту. Отримайте знання цього словника, і ви будете готові до впевненого спілкування у будь- якому контексті DevRel.

Розв’язання проблеми: розв’язати задачу про нескінченні множини

Для не рідних англомовних носіїв, що пересуваються у світі Developer Relations (DevRel), нюанси професійного спілкування можуть бути особливо викликом. Це не просто переклад технічних термінів; це передавання намірів, ефективне оформлення ідей в спільному середовищі і розуміння немовлячих очікувань. Частою перешкодою є тонкі відмінності в тому, як дається зворотній зв’язок, особливо при обговоренні коду або прогресу проекту. Розглянемо сценарій: Сара, старший інженер нового проекту API, отримує коментар щодо запитів на збирання від Девіда, молодшого розробника. Замість того, щоб просто сказати «Це потребує роботи», Девід пише: «Чи не могли б ви переглянути обробку помилок в цьому розділі? Поточний підхід недостатньо надійний для використання в виробництві.” Різниця є значною. Сара спочатку може інтерпретувати «необхідна робота» як нечітку критику, що може призвести до плутанини щодо того, що конкретно вимагає уваги. Формулювання Девіда, хоча і технічно точніше, може бути сприйнято як надто критичне або вимогливе без додаткового контексту «достатньо міцний для використання в виробництві»

Інша поширена область труднощів виникає при описі досліджень досвіду розробників - часто включаючи інтерв’ю з користувачами і аналіз зворотнього зв’язку. Фрази на кшталт «низько висять фрукти» або «пересунути голку» можуть звучати абстрактно і жаргонно, особливо якщо основні поняття не повністю зрозумілі. Аналогічно, при створенні PR-описів для нових можливостей, зосередження виключно на технічних специфікаціях без підкреслення * переваги * для розробника є втраченою можливістю. Хороший опис PR повинен чітко сформулювати, як зміна вирішує проблему або покращує робочий процес. Важливо пам’ятати, що чітке і коротке спілкування не тільки про точність; це про будівництво відносин і створення продуктивного середовища, де кожен розуміє свою роль і внесок. Створення цього розуміння вимагає активного слухання, запитання прояснюючих питань («Чи можете ви розібратися, що ви маєте на увазі під «досить міцним»?»), І активне надання контексту, коли це необхідно.

Крім того, мова, використана в каналах Slack, часто вимагає негайної реакції і точності. Здається нешкідливим повідомлення, наприклад, «Давайте синхронізувати», може бути інтерпретовано по-різному в залежності від розуміння отримувачем «синхронізації». Это может означать официальную встречу или просто быструю регистрацию. Явно заявивши ваш намір - “Чи маєте ви 15 хвилин, щоб швидко переглянути це оновлення?” - вилучає неоднозначність і забезпечує, що всі вирівняні. Врешті-решт, успішний DevRel сильно залежить від встановлення довіри через чітке, емпатичне спілкування.

Ось приклад використання git diff для підсвічування змін у запиті на завантаження:

git diff --color --patch my_feature.py

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