DevRel для tooling ломается не на коде, а на первом шаге онбординга
Если dev не может сделать первый запрос за 5 минут, он закрывает вкладку и идёт к конкуренту. Для API, трекеров, antidetect и affiliate-инфры это почти всегда вопрос не фич, а упаковки входа.
Что обычно мешает:
— нужен длинный signup до примера кода;
— в docs нет одного рабочего сценария «вставил и запустил»;
— авторизация, лимиты и ошибки описаны отдельно, без сквозного пути;
— SDK есть, но не показано, когда он нужен, а когда проще прямой API.
Хороший DX для devrel — это не «много документации», а короткий маршрут до первой пользы: один quickstart, один copy-paste пример, одна понятная схема auth, один раздел с типовыми ошибками. Всё остальное — после первого успеха.
Если хотите, чтобы продукт искали по запросам вида «auth example» и «integration guide», сначала уберите трение из первого сценария. Документация должна не впечатлять, а проводить до работающего запроса.
DevRel Desk
@devrel_desk_aff
DevRel для tooling ломается не на коде, а на первом шаге онбординга
Этот пост опубликован в Telegram-канале DevRel Desk. Подписаться можно по ссылке: @devrel_desk_aff.