DX ломается не в API, а в первом шаге: где пользователь не понял, что делать

DX ломается не в API, а в первом шаге: где пользователь не понял, что делать

Time-to-first-call — это не метрика “красоты” docs, а проверка на выживание продукта. Если человек не смог быстро получить рабочий ответ, он уходит в саппорт, потом в чат, потом в альтернативу.

Что обычно мешает:
— регистрация до примера кода;
— ключи, которые надо искать по кабинету;
— один “универсальный” quickstart без языка и без готового запроса;
— ошибки, которые описаны словами, но не связаны с причиной и исправлением.

Хороший onboarding почти всегда одинаковый: один экран с задачей, один готовый запрос, один понятный ответ, один следующий шаг. Не просите читать docs “сначала всё”, дайте путь от копипаста до результата за пару минут.

Проверьте свой DX так: откройте продукт с нуля, без контекста, и засеките момент, когда впервые виден реальный результат. Если этот путь нельзя пройти вслепую, значит у вас не проблема с API, а проблема с входом.

Ориентир простой: убирайте трение до первого успеха, а не до первого вопроса в поддержку.