DevRel не спасает продукт, если первый запуск ломается на простых шагах
Первое правило DX: деву нужен не «бренд», а первый рабочий запрос. Если он не может за 5–10 минут получить ответ от API, он уходит в поиск и больше не возвращается.
Проверьте onboarding по трём точкам:
— ключи и auth: где взять, куда вставить, как понять, что токен живой;
— минимальный пример: curl, Python и один понятный ответ без лишнего шума;
— ошибки: код, текст, причина, что делать дальше. Без «something went wrong» 🙂.
Документация должна вести по сценарию, а не по структуре компании. Дев ищет не раздел «О нас», а «как создать запрос», «как поймать webhook», «как отладить 403».
Если в SDK много магии, вынесите её в явные методы и названия. Чем меньше скрытого поведения, тем меньше вопросов в саппорт и тем выше шанс, что продукт встроят в рабочий стек.
Смотрите на DevRel как на сокращение пути до первой ценности: убрать лишние шаги, показать рабочий пример и сделать ошибки объяснимыми. Это и есть нормальный старт для developer-аудитории.
DevRel Desk
@devrel_desk_aff
DevRel не спасает продукт, если первый запуск ломается на простых шагах
Этот пост опубликован в Telegram-канале DevRel Desk. Подписаться можно по ссылке: @devrel_desk_aff.