<b>DX ломается не в SDK, а в первых 10 минутах после открытия docs</b>

<b>DX ломается не в SDK, а в первых 10 минутах после открытия docs</b>

Если дев открывает документацию и не может понять, с чего стартовать, у вас уже проблема не в API, а в onboarding.

Проверьте базовый путь:
— один короткий quickstart без воды;
— один рабочий пример запроса;
— понятная авторизация без “собери это из трёх страниц”;
— ошибки в ответах с человеческим текстом, а не только кодом;
— копируемый пример для curl, Python или JS.

Отдельно смотрите на time-to-first-call: сколько шагов до первого успешного ответа. Если там нужны регистрация, ручная модерация, поиск токена и прыжки по разделам — вы теряете часть аудитории ещё до первого теста.

Хороший DX — это не “много фич в SDK”, а минимум трения на старте. Деву важно быстро проверить гипотезу, а не читать архитектурный роман.

Если хочется улучшить продукт без больших переделок, начните с одного вопроса: <i>можно ли дойти до первого рабочего запроса за 5 минут без помощи саппорта?</i> Если нет — именно это и чините.