Англійська мова для відносин з розробниками: словник і комунікація для DevRel
Захист розробників, створення спільноти, технічний вміст, написання CFP і словник DevRel для захисників розробників.
Відносини з розробниками — або DevRel — виросли з нішової ролі в одну з найпомітніших кар’єр в технологічній індустрії. Якщо ви інженер з розробки програмного забезпечення, який бажає зайнятися захистом прав користувачів, технічний письменник, який розширює свій діапазон знань, або просто хтось, хто працює разом з захисниками прав користувачів, освоєння спеціалізованого словника з цієї області допоможе вам впевнено спілкуватися на конференціях, у мережевих спільнотах і всередині вашої організації.
У цьому довіднику ви дізнаєтеся про основні терміни, які використовуються щодня у DevRel, побачите, як люди з рідною англійською мовою використовують ці терміни у реальних розмовах, і закінчите цей довідник таблицею швидкого доступу, яку ви можете додати до закладок.
Основні поняття: ролі та обов’язки
Понять, кто что делает, это первый шаг. Наступні терміни описують людей і команди, які стоять за роботою, що стосується розробників.
** Відносини з розробниками (DevRel) ** — практика створення значущих відносин між компанією і розробниками, які використовують її продукти або API. DevRel знаходиться на перетині інженерії, маркетингу і управління спільнотою.
«Ми розширюємо нашу програму DevRel, тому що зворотній зв’язок від спільноти є найшвидшим способом поліпшити наш SDK»
Вона перейшла з backend engineering в DevRel — вона каже, що поєднання кодування і комунікації ідеально підходить їй
** Заступник розробника ** — професіонал, який представляє розробників всередині компанії і представляє компанію перед розробниками поза нею. Роль включає створення контенту, виступи на заходах, написання зразків коду і збір відгуків.
«Наш адвокат розробників провів три семінари на конференції, і кожен з них був повністю заброньований протягом години»
«Як заступник розробника, моя основна робота — вислухати те, що спільнота вважає заплутаним, а потім повернути це команді продукту»
** Менеджер спільноти ** — особа, яка відповідає за підтримку мережевої або офлайн- спільноти розробників: модифікацію обговорень, організацію подій, а також за те, щоб члени спільноти відчували себе запрошеними і почутими.
Менеджер спільноти помітив, що питання про автентифікацію ставляться неодноразово, тому вона написала спеціальну сторінку FAQ
«Хороше управління спільнотою невидиме — коли це добре зроблено, члени просто відчувають, що простір дружній»
** Технічний євангеліст ** — старіша назва для ролі, подібної до адвоката розробника, з більшим акцентом на просуванні технології і надиханні розробників на її прийняття. Термін менш поширений сьогодні, але все ще з’являється в списках вакансій у більших компаніях.
«Технічний євангеліст дав переконливу промову про те, чому новий час роботи зменшує час холодного запуску на сорок відсотків»
Платформа і продуктовий словник
Ці терміни описують те, що створюють фахівці DevRel і середовища, в яких вони працюють.
Екосистема — ширша мережа інструментів, бібліотек, партнерів, інтеграцій і спільнот, що оточують технологічну платформу.
«Будівництво здорової екосистеми займає роки — вам потрібні сторонні співробітники, незалежні блогери і партнери з інтеграції, які тягнуть в одному напрямку»
Їх екосистема є однією з найбагатших в індустрії; є понад дві тисячі плагінів, підтримуваних спільнотою
** Досвід розробника (DX) ** — загальна якість подорожі розробника під час використання продукту: наскільки легко почати, наскільки чітко документація, і наскільки швидко проблеми можна розв’ язати. DX є еквівалентом для розробників досвіду користувача (UX).
«Ми провели аудит DX в минулому кварталі і виявили, що поток впровадження втрачав розробників на третьому кроці»
«Гарантований DX означає, що розробник може перейти від нуля до робочого прототипу за менше ніж п’ятнадцять хвилин»
** Журнал тривання ** — структурований документ, у якому розробник записує кожну точку заплутаності, труднощі або дратування, з якими він стикається під час спроб використовувати продукт. Журнали тертя є безцінними для визначення місць, де документація або інструменти потребують поліпшення.
«Я написав журнал тертя, дотримуючись нашого власного посібника з швидкого запуску і знайшов чотири місця, де інструкції були застарілими»
“Перед тим, як ми запустимо новий CLI, чи може хтось зробити ретельний журнал тертя? Нам потрібні свіжі очі на процес установки»
** Підручник з швидкого запуску ** — короткий, зосереджений на певній темі розділ документації, призначений для того, щоб розробник міг якомога швидше приступити до роботи, зазвичай, за декілька хвилин. Швидкість має перевагу над повністю.
«Швидкий посібник повинен вміститися на одній сторінці — якщо це не так, нам потрібно оптимізувати сам процес налаштування, а не тільки документацію»
«Нові користувачі рідко читають повний посилання; вони прямують прямо до посібника з швидкого запуску і тільки звертаються до глибших документів, коли вони стикаються з проблемою»
** Прикладна програма ** — невелика, функціональна програма, яка демонструє, як використовувати продукт або API у реалістичному контексті. На відміну від мінімального фрагмента коду, прикладна програма показує, як різні частини підходять разом.
«Ми побудували прикладну програму, яка поєднує автентифікацію, оновлення в реальному часі і завантаження файлів, щоб розробники могли побачити повну картину»
«Прикладне застосування є артефактом, який отримує найбільше зірок на GitHub — він відповідає «але як я можу використовувати це в реальному проекті?»
Конференція та словник
Велика частина роботи DevRel включає виступи на конференціях і виробництво письмового контенту. Ці терміни допоможуть тобі знайти шлях у цьому світі.
** CFP (заклик до пропозицій) ** — відкрите запрошення від конференції або події для спікерів надати ідеї для розмови. Відповідь на CFP - це те, як починаються більшість конференційних переговорів.
Процитовано 2013-09-10. The CFP for KubeCon closes at the end of the month — have you submitted your proposal yet?
«Ми відстежуємо кожну велику CFP в спільній електронній таблиці, щоб команда могла координувати і уникати перетинів тем»
** Пропозиція щодо розмови ** — документ, надісланий у відповідь на запит CFP, зазвичай, включає назву, резюме, біографію ведучого, а іноді і загальний план або завдання з навчання.
«Я провів дві години, щоб відшліфувати свою пропозицію до виступу, перш ніж надіслати її — резюме є єдиним, що рецензенти бачать спочатку, тому воно має бути переконливим»
«Її пропозиція була прийнята з першої спроби, тому що вона була конкретною про те, що учасники зможуть зробити по-іншому після цього»
** Резюме доповіді на конференції ** — короткий публічний опис доповіді, зазвичай від ста до трьохсот слів, який з’ являється у програмі події. Вона повинна чітко передати цінність розмови і залучити правильну аудиторію.
«Написання сильного резюме конференції є вміння само по собі — вам потрібно захопити читача в першому реченні.»
«Рецензенти читають сотні рефератів; ваші повинні сказати, яку проблему вони вирішують в перших двох рядках»
** Keynote ** — головна промова на конференції, зазвичай, вона відбувається у великому залі перед усіма присутніми. Основні доповіді, як правило, зарезервовані для високопрофільних мовців або великих оголошення про продукт.
«Бути запрошеним на конференцію розробників є важливою віхою для будь-якого адвоката.»
«Відкриття Keynote задав тон для всього заходу — він був енергійним, демо-важким, і закінчився з несподіваним запуском продукту.»
** Технічний запис у блогу ** — довгий письмовий матеріал, у якому пояснюється концепція, описується навчальний посібник або висловлюється думка на технічну тему. Технічні блоги є основним форматом вмісту в DevRel, оскільки їх можна знайти за допомогою пошуку і повторно використовувати в багатьох контекстах.
«Ми плануємо публікувати два технічні блоги на місяць — один навчальний посібник і один матеріал для висловлення думки»
«Хорошо написаний технічний блог може привести більше кваліфікованих розробників до вашого продукту, ніж платна реклама могла б»
Live demo — демонстрація продукту або можливості у реальному часі, зазвичай, виконується під час конференції або вебінару. Живі демо-версії мають великий вплив, але несуть ризик; багато адвокатів практикують одержимо, щоб зменшити шанс невдачі на сцені.
«Ніколи не недооцінюйте, скільки часу займає підготовка живого демо — те, що виглядає без зусиль на сцені, представляє години репетицій»
«Живе демо втрачено на другому слайді, але вона граціозно відновилась і публіка дійсно аплодувала їй за це»
** Керування спільнотою Discord/Slack ** — щоденна робота з керування спільнотою розробників на платформі чату: прийом нових членів, відповіді на запитання, виконання рекомендацій спільноти і створення каналів або гілок, що заохочують продуктивну розмову.
«Менеджмент спільноти Discord — це робота на повну ставку сама по собі — ви, по суті, модифікуєте міську площу, яка ніколи не спить»
«Ми перенесли нашу спільноту з Slack на Discord минулого року, тому що безкоштовний рівень на Slack вилучив нашу історію повідомлень»
Як використовувати їх у розмові
Знати термін - це не те ж саме, що розуміти його. Ось декілька природних шаблонів, які регулярно з’ являються у розмовах DevRel.
Коли ** обговорюєте свою роль **, будьте конкретними: “Я зосереджуюся на відкритій стороні нашої екосистеми розробників - в основному управління спільнотою і прикладні програми.”
При написанні CFP-заявки, починайте з проблеми: “Розробники часто стикаються з X. У цій розмові я покажу вам, як зробити Y, роблячи Z»
При ** представленні DX зворотного зв’язку внутрішньо **, проблеми з рамками як можливості: “Наш журнал тертя визначив три точки, де розробники відходять. Виправлення цих помилок може значно поліпшити наш рівень активації»
Коли ** розмовляєте про стратегію контенту **, з’єднуйте артефакти з результатами: “Кожен технічний блог, який ми публікуємо, підтримує різні етапи подорожі розробника - від початкового керівництва для початківців до розширених навчальних посібників для потенційних користувачів”
Таблиця швидких посилань
| Term | What It Means |
|---|---|
| DevRel | Developer Relations — building relationships between a company and its developer community |
| Developer advocate | Bridges the gap between a company’s product and its developer users |
| Community manager | Runs and moderates online/offline developer communities |
| Developer experience (DX) | The overall quality of using a developer product, from first sign-up to advanced use |
| Friction log | A document recording every painful or confusing step in a developer workflow |
| Quickstart guide | Short documentation to get developers working as fast as possible |
| Sample app | A realistic demo application showing how a product fits together end-to-end |
| CFP | Call for proposals — an open invitation to submit conference talk ideas |
| Talk abstract | The public description of a conference session, used to attract the right audience |
| Live demo | A real-time product demonstration, typically performed on stage or in a webinar |
Незалежно від того, надсилаєте ви свій перший CFP, пишете журнал конфліктів для вашої команди або керуєте спільнотою Discord, яка ніколи не спить, правильний словник зробить ваше спілкування більш чітким і ваш авторитет сильнішим. Терміни в цьому посібнику використовуються щодня розробниками і менеджерами спільноти, які формують інструменти і платформи, на які покладаються інженери по всьому світу.