DX ломается не в коде, а в первом часу: где новичок спотыкается
Первый запрос должен получаться без переписки с поддержкой. Если для старта нужны 5 вкладок, ручной токен и «смотрите пример в блоге», onboarding уже течёт. Нормальный путь: install → auth → один рабочий call → понятный ответ.
Смотрите на три вещи:
— auth без сюрпризов: короткий пример для curl, Python и JS
— ошибки не «500», а текстом: что сломалось, где и как чинить
— данные в ответе стабильны: поля не прыгают, типы не пляшут, пустые значения описаны
Docs тоже часть DX. Если документация живёт отдельно от SDK, а примеры расходятся с реальным API, дев не доверяет продукту. Лучше один короткий quickstart, чем десять страниц описаний без кода. И да, скрипт из README должен запускаться без правок.
Ещё один маркер: как продукт ведёт себя на плохих входах. Хороший API не прячет лимиты, не молчит на неверный формат и не заставляет гадать, почему запрос завис. Чем раньше человек видит предсказуемую ошибку, тем меньше шансов, что он закроет вкладку.
Если хотите сильный DX, уберите всё, что мешает первому успешному запросу: лишние шаги, неявные зависимости, разъехавшиеся примеры. Первые 10 минут важнее красивого сайта.
DevRel Desk
@devrel_desk_aff
DX ломается не в коде, а в первом часу: где новичок спотыкается
Этот пост опубликован в Telegram-канале DevRel Desk. Подписаться можно по ссылке: @devrel_desk_aff.