DevRel в tooling — это не «вести блог» и не «делать комьюнити ради комьюнити». Если дев не может быстро получить токен, вызвать первый метод и понять, где смотреть ошибку, он уходит.
— Time-to-first-call должен измеряться не днями, а шагами: регистрация, ключ, пример запроса, ответ, разбор ошибки. Если на этом пути нужен созвон или письмо в саппорт — onboarding уже сломан.
— В quickstart давайте один сценарий, а не каталог возможностей. Один рабочий путь лучше десяти разделов «всё обо всём». Дев сначала хочет скопировать код, потом уже читать про архитектуру.
— Ошибки пишите человеческим языком: что сломалось, где искать причину, как исправить. Сообщение вида invalid_request без контекста — это не API, а квест.
— SDK и docs должны совпадать. Если в примере один параметр назван иначе, чем в библиотеке, доверие к продукту падает быстрее, чем трафик на плохом лендинге.
— Не прячьте ограничения. Лимиты, авторизация, webhook-нюансы, формат ретраев — это не «минусы продукта», а то, что помогает внедрить его без сюрпризов.
Хороший DevRel в арб-tooling — это когда у разработчика меньше вопросов к старту и больше шансов дойти до интеграции без лишних кругов.
Реклама на лиды: формы в Фейсбук
@leadforms_ads
DevRel для API-инструмента: 5 вещей, без которых docs и SDK не взлетают
Этот пост опубликован в Telegram-канале Реклама на лиды: формы в Фейсбук (@leadforms_ads). Все его публикации — на странице канала.
Открыть в Telegram