⭐️Мы приняли решение заменить систему управления и генерации пользовательской и админской документации внутри Cloudlink: вместо Wiki.js теперь используем Antora. С этой платформой информация для наших пользователей доступна в более удобном формате, а работа системы стала гораздо стабильнее.

И вот почему:

⭐️ Теперь каждая версия Cloudlink сопровождается своей версией документации.

⭐️Antora не требует отдельных инфраструктурных сервисов (в отличие от Wiki.js).

⭐️Деплой стал проще — больше не нужно синхронизироваться с внешними репозиториями, все работает «из коробки».

⭐️Можно легко кастомизировать дизайн, приведя документацию к фирменному стилю Cloudlink (или клиента).

А еще Antora упрощает работу технических писателей за счет более удобного процесса генерации документации.

💬 А чем вы пользуетесь для генерации документации? Альтернативные wiki-движки? Собственные решения? Давайте обсудим плюсы и минусы в комментариях.

#cloudlink #documentation