<b>DX ломается не в API, а в первом «покажи пример» и пустом error message</b>

<b>DX ломается не в API, а в первом «покажи пример» и пустом error message</b>

Если деву нужно открыть docs и за 3 минуты понять, как сделать первый рабочий запрос — это уже хороший старт. Если он упирается в регистрацию, токен, роли, CORS, лимиты и ещё три «сначала настройте», Time-to-first-call растягивается без пользы.

Проверяйте onboarding по простому сценарию:
— можно ли получить ключ без общения с sales;
— есть ли один минимальный пример на самом частом языке;
— понятно ли, куда вставить токен и где увидеть результат;
— показывает ли SDK/CLI живую ошибку, а не «failed».

Самая частая поломка DX — документация описывает все возможности, но не ведёт к первому успеху. Дев не ищет полотно разделов, ему нужен короткий путь: auth → request → response → next step. Лучше один рабочий quickstart, чем пять страниц «архитектурных преимуществ».

Ещё один маркер: копипастится ли пример в чистый проект без ручной магии. Если нет, значит в docs спрятаны зависимости, переменные окружения, заголовки или формат данных, о которых забыли сказать.

Хороший DX — это когда первый запрос можно собрать без переписки с поддержкой. Всё остальное уже оптимизация.