В новом шаблоне читательского интерфейса Next теперь можно настраивать навигацию, вёрстку страниц и брендирование. Ссылки на страницы и файлы находятся за секунды, а новые методы API позволяют связать доступ к документации с вашей CRM или системой подписок.
Настраивайте шаблон Next под свою документацию
В шаблоне читательского интерфейса Next вы сами решаете, как читатели перемещаются по документации. Можно показывать полное оглавление рядом с каждой страницей или скрыть панель навигации, чтобы ничто не отвлекало от содержимого. Ширину текста тоже можно подобрать под свои материалы.
Новые настройки касаются и брендирования: задайте свои цвета и добавьте футер со ссылками на ваш сайт, контактами или юридической информацией. Всё это задается в настройках читательского интерфейса. Если вы переходите с устаревшего шаблона, читайте здесь, какие настройки поддерживает Next.
Сначала проверяйте ссылки, потом меняйте
Прежде чем переименовать, заменить или удалить страницу или файл, важно знать, что на них ссылается. Глобальный поиск и замена находит такие ссылки за секунды даже на больших порталах, и там же их можно просмотреть и поправить. Так же быстро работают просмотр ссылок и «Где используется этот файл?». Последний ищет ссылки на любые файлы, включая стили и скрипты.
Перед удалением проекта или публикации Документерра показывает, сколько страниц на них ссылается. Эти ссылки можно просмотреть в Глобальном поиске и замене и исправить, прежде чем продолжить.
Управляйте доступом к документации из вашей CRM или системы подписок
Если вы делитесь закрытой документацией с клиентами или партнёрами, групповой доступ теперь можно связать с записями в вашей CRM или в системе подписок. API Документерры v2 позволяет разработчикам управлять группами доступа, их правами и участниками прямо из этой системы.
Например, клиент, купивший продукт, может автоматически попадать в группу с доступом к документации по этому продукту.
API работает по тем же правилам доступа, что и интерфейс. Группы авторизованных читателей получают доступ к закрытым публикациям, группы рецензентов — к проектам, а также к приватным и закрытым публикациям. Для этого нужен модуль API в лицензии. Чтобы управлять группами авторизованных читателей, в лицензии также должен быть закрытый доступ, а группами рецензентов — роль рецензента.
Улучшения
Когда вы добавляете ключевые слова к странице, редактор подсказывает подходящие из тех, что уже есть на портале, включая ключевые слова второго уровня. Не нужно помнить, как слово написано на других страницах, поэтому в списке ключевых слов меньше дублей и опечаток. Новое ключевое слово по-прежнему можно ввести вручную.
Через API теперь можно импортировать документацию из CHM, PDF, GitBook, ReadMe, Document360, MadCap Flare и Author-it, чтобы автоматизировать импорт и миграцию.
ИИ-агенты лучше находят открытую документацию на вашем портале. Это часть нашей постоянной работы над тем, чтобы ИИ-инструментам было проще находить и читать документацию. Доступ определяется видимостью публикаций, а robots.txt подсказывает поисковым роботам, какие страницы обходить.