Обновления документации Konso: API стало удобнее для людей и ИИ
Мы продолжаем улучшать документацию Konso, чтобы с платформой было одинаково удобно работать как разработчикам, так и AI-ассистентам. В этом обновлении сосредоточились сразу на трех важных направлениях.
📚 Полностью обновили API Reference
Мы переработали раздел API Reference, сделав его более структурированным и удобным для навигации.
Что изменилось:
- улучшена структура разделов;
- стало проще находить нужные методы и модели;
- документация стала более последовательной и понятной;
- ускорилась навигация между связанными сущностями.
Теперь поиск нужной информации занимает меньше времени, а интеграция с Konso становится еще быстрее.
🤖 Добавили Markdown-версию каждой страницы для AI-агентов
Современная документация должна быть удобна не только человеку, но и искусственному интеллекту.
Теперь у каждой страницы документации появилась отдельная ссылка на версию в формате Markdown. Такой формат значительно лучше подходит для AI-инструментов, включая GigaChat, Yandex, Claude, Codex и другие IDE с AI-помощниками.
Это позволяет:
- использовать документацию как контекст для AI;
- быстрее генерировать код интеграций;
- получать более точные ответы при работе с API;
- снизить количество ошибок, связанных с интерпретацией HTML-страниц.
Если вы разрабатываете вместе с AI, рекомендуем использовать именно Markdown-версии документации.
♿ Исправили критические проблемы доступности (WCAG)
Мы также уделили внимание доступности сайта и устранили ряд критических замечаний в соответствии с рекомендациями WCAG.
В частности были исправлены проблемы, связанные с:
- навигацией с клавиатуры;
- семантической разметкой;
- контрастностью отдельных элементов;
- корректной работой со скринридерами.
Доступность — это не только соответствие стандартам, но и более качественный пользовательский опыт для всех посетителей сайта.
Что дальше
Мы продолжаем активно развивать документацию Konso. В ближайших обновлениях планируем сделать её еще удобнее как для разработчиков, так и для AI-агентов, которые становятся полноценными участниками процесса разработки.
Если у вас есть идеи, чего не хватает в документации, обязательно напишите нам — мы внимательно изучаем обратную связь и регулярно включаем предложения пользователей в план развития платформы.