DX ломается не в API, а в первом часе: где теряется дев и почему

DX ломается не в API, а в первом часе: где теряется дев и почему

Time-to-first-call умирает не на сложных сценариях, а на банальном старте: ключи ищут в двух местах, пример не совпадает с SDK, а auth описан отдельно от запроса. Если человеку нужно открыть 4 страницы, чтобы сделать первый `curl`, он уже считает продукт «тяжёлым».

Проверь onboarding по трём точкам:
— можно ли скопировать пример и запустить его без правок;
— есть ли один путь для quickstart, а не три взаимоисключающих;
— совпадают ли названия полей в docs, SDK и ответах API.
Если в ответе `account_id`, а в примере `id`, дев начинает гадать, а не интегрировать.

Вторая типовая поломка — скрытые зависимости. Когда для теста нужен доступ к прод-аккаунту, ручная верификация или отдельный чат с саппортом, self-serve превращается в support-driven onboarding. Для tooling это особенно больно: разработчик хочет проверить гипотезу сам, без пинга менеджеру.

Хороший DX — это не «красивые docs», а короткий путь до рабочего запроса, понятные ошибки и один очевидный пример для первого успеха. Уберите лишние развилки, и продукт начнут не хвалить, а подключать.