DX ломается не в API, а в первом «а где пример?» после открытия docs

DX ломается не в API, а в первом «а где пример?» после открытия docs

Первый запрос должен быть достижим без гаданий. Если человек не видит auth, base URL и рабочий пример в одном экране, он уходит искать чужой gist или бросает интеграцию.

Проверьте onboarding по трём точкам:
— авторизация: один способ входа, без расползания по разным страницам;
— quickstart: минимальный сценарий от токена до ответа;
— ошибки: не «failed», а понятное сообщение, причина и пример исправления.

Дальше — не заставляйте девов собирать пазл из SDK, API и webhooks. Когда сущности называются по-разному в docs и в коде, растёт не сложность продукта, а цена входа. Хороший DX — это когда названия, поля и примеры совпадают между собой и не требуют внутреннего перевода.

Ещё один маркер: если для теста нужен «боевой» доступ или ручная активация через саппорт, это уже не onboarding, а очередь. Лучше дать sandbox, тестовые ключи и один путь до первого успешного вызова.

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