DX ломается не в SDK, а в первом запросе: как не потерять разработчика

DX ломается не в SDK, а в первом запросе: как не потерять разработчика

Time-to-first-call — это не метрика для слайдов, а путь от “открыл docs” до “получил ответ”. Если на этом маршруте есть лишняя регистрация, неясный auth, ручной поиск endpoint’а или пример без рабочей структуры — дев уйдёт молча.

Проверьте onboarding по простому чек-листу:
— можно ли запустить запрос без общения с саппортом;
— есть ли один короткий quickstart, а не 12 страниц “общее описание”;
— пример копируется и работает без правок;
— ошибки пишутся человеческим языком, а не кодом без контекста.

Дальше смотрите на SDK как на мост, а не на витрину. Хороший SDK не прячет API, а убирает повторяющиеся действия: auth, ретраи, пагинацию, валидацию. Плохой — добавляет слой, который надо изучать отдельно. Если SDK требует читать два набора docs, значит вы увеличили не DX, а длину пути.

И ещё одна вещь: документация должна отвечать на вопрос “как сделать”, а не “почему мы такие”. Для девелопера важны примеры под его стек, понятные названия методов и один очевидный путь старта. Если первый рабочий сценарий найден за минуту — вы уже выиграли половину онбординга.