Англійська мова для розробників Community Building

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

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

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

** Менеджер спільноти ** — особа, яка відповідає за зростання, залучення і підтримку спільноти користувачів або розробників. “Наше керівництво спільноти стежить за форумом, вітає нових членів і модерує дискусії, щоб цей простір був завжди відкритим для всіх.”

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

Рівень залученості — метрика, яка вимірює, наскільки активно члени спільноти беруть участь у роботі відносно загального розміру спільноти. “Наш рівень залученості в Discord становить 18% — майже один з п’яти членів публікує щонайменше раз на місяць.”

** Вступ** — процес прийняття нових членів спільноти і допомоги їм у перших кроках. “Добре впровадження означає, що новий член може пройти від приєднання до Discord до надсилання свого першого запиту на витягування впродовж тижня.”

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

** Churn ** — рівень, за якого члени спільноти стають неактивними або залишають її. “Перехід спільноти збільшився після того, як ми змінили платформу форуму — члени не хотіли мігрувати свою історію.”

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

Вітаємо нових членів

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

• “Ласкаво просимо до спільноти! Ми раді, що ти тут»
• «Не соромтеся представити себе в каналі #introductions — скажіть нам, що ви будуєте»
• «Не варто запитувати, — тут немає занадто простих питань»
• «Наша інструкція по запуску є найкращим місцем для початку: [посилання]»
• Якщо ви застрягнете, позначте @community-team і ми допоможемо вам знайти правильний ресурс

Мова планування подій

Незалежно від того, проводите ви віртуальну зустріч, хакатон або конференцію, використовуйте цей словник.

• Ми проводимо віртуальний семінар наступного четвертого — принесіть свої питання і ми будемо кодувати разом»
• «Реєстрація відкрита — місця обмежені, тому записуйтесь рано»
• “Хакетон триватиме 48 годин. Команди можуть мати від двох до п’яти членів»
• «Ми маємо три треки: початківець, середній і досвідчений. Виберіть той, який підходить вашому рівню досвіду»
• «Нагороди будуть вручатися за найкраще використання API, найбільш творчий проект, і найкраще подачу початківців.»

Визнавання внесків

• «Велике подяка @username за їх чудовий посібник з інтеграції нашого SDK з Next.js — це вже допомогло десяткам розробників»
• Найбільшим автором цього місяця є @username, який відповів на 47 питань на форумі
• Ми додаємо @username на нашу сторінку співробітників — дякую за ваш перший запит на витягнення!»
• «Ваш відгук безпосередньо сформував нову функцію обмеження швидкості в v2.3 — дякую за підняття цього питання»

Здоров’я населення

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

• «Ми зараз маємо 8400 активних членів по Discord, GitHub Discussions, і форуму.»
• «Місячні активні члени зросли на 12% в останньому кварталі, завдяки новій серії навчальних матеріалів»
• Середній час відповіді на питання на форумі менше 4 годин — це сильний сигнал здоров’я спільноти»
• «Ми відстежуємо спад у перших внесках цього місяця — ми розслідуємо, чи потрібно оновлення посібника для внесків»

Професійні поради

1. ** Відповідай публічно, коли це можливо. ** Відповідь на питання у публічних каналах створює знання, які можна використовувати для пошуку. Приватні відповіді допомагають одній особі; публічні відповіді допомагають всім.
2. ** Використовуйте інклюзивну мову. ** Не використовуйте фрази типу « хлопці » або « він ». Використовуйте « всі », « люди » або « вони », щоб привітати всіх членів.
3. ** Вшановуйте невеликі внески. ** Спільнота, яка визнає лише великі внески, не дає змоги початківцям. Дякуємо людині, яка виправила помилку друку, так само, як ви дякуєте людині, яка додала важливу функціональність.
4. Встановіть чіткі правила поведінки для спільноти. Кодекс поведінки, написаний простою, доступною англійською мовою, визначає очікування і полегшує модерацію.

Практичні вправи

1. Напишіть привітання (4- 5 речень) для нового члена, який вперше приєднується до сервера спільноти розробників Discord.
2. Ви помітили, що нові члени приєднуються, але не надсилають повідомлень після першого тижня. Напишіть 3- 4 речення, в яких запропонуйте дві зміни до процесу впровадження, щоб поліпшити залучення.
3. Член спільноти цього місяця відповів на 100 питань на форумі. Написати публічний пост з подякою (3- 4 речення) для новинного бюлетеня.

Розробка спільних дій: практичний підхід

Створення процвітаючого співтовариства розробників не просто про те, щоб збирати разом події; це фундаментально про сприяння продуктивному діалогу. Значна частина цього діалогу неминуче буде включати різні думки, технічні розбіжності або критику коду. Освоєння англійської лексики, що стосується конструктивного зворотнього зв’ язку, є * критичним * для підтримки позитивного та співпрацюючого середовища. Багато не-рідних носіїв борються з вираженням інакодумних поглядів безпосередньо, часто за замовчуванням надто ввічливі фрази, які можуть бути неправильно інтерпретовані як згода або пасивне прийняття. І навпаки, тупа критика, погано доставлена, може негайно звести нанівець дискусії.

Розглянемо сценарій: Під час перегляду коду запиту на витяг, наданого Еленою для нової можливості в модулі authentication, переглядач, Девід, помічає потенційну вразливість безпеки. Замість того, щоб просто сказати «Це погано», що може бути сприйнято як надмірне осудження, Девід використовує ретельно обрану мову. Він починає з визнання зусиль Елени: «Елена, це дійсно міцний початок потоку автентифікації - я ціную вас за боротьбу з цією складною областю!» Потім він чітко сформулює свою занепокоєність без приписування звинувачення: «Я визначив потенційну проблему щодо обмеження швидкості; здається, що ми можемо бути вразливими до атак з використанням брутальної сили, якщо не будемо правильно вирішувати. Варто дослідити реалізацію надійного механізму обмеження тут. “Ключеве значення має те, що він йде з пропозицією для усунення: “Можливо, додавання простої затримки sleep() після кожного запиту може забезпечити початковий шар захисту, поки ми досліджуємо більш складні рішення.” Цей підхід поєднує позитивне підсилення, точну технічну мову і дії керівництва.

Інша поширена ситуація виникає в каналах Slack, присвячених обговоренню проектів. Розробник Марк задає запитання щодо оптимізації швидкодії запиту: « Чи є у когось поради щодо прискорення цього запиту SQL? Це триває вічно!» відповідь від Сари може бути: «Чи ви розглядали можливість використання індексу на стовпці user_id? Це часто є значною перешкодою. “Це не просто заява про факт; це пропонує специфічне рішення, вкладене в контекст потенційного поліпшення. Використання фраз на кшталт «варто дослідити» або «хороша початкова точка» пом’якшує пропозицію і запрошує до подальшого обговорення, а не представляє її як остаточну відповідь.

Нарешті, пам’ятайте, що чітка документація - включаючи описи PR - є життєво важливою для поділу знань і розуміння. Добре написаний опис може виглядати так: « Виправлення: Впроваджено обмеження швидкості, щоб запобігти можливим атакам з використанням жорстокої сили на службу розпізнавання. Додано 1-секундну затримку після кожного запиту, щоб забезпечити негайний захист, поки проводиться подальше дослідження більш складних стратегій обмеження. ”

# Example of using `curl` with rate limiting (conceptual)
curl -v --max-time 1 "https://example.com/api/login"  # Simulate a request, limited by delay

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