Переход на новую базу знаний

В прошлой части я объяснил, почему мы выбрали Docusaurus. Выбор сделан, но «движок» сам по себе — это просто куча JS-файлов. Чтобы всё это реально заработало в компании, нужно было подружить его с нашими репозиториями, настроить автоматическую сборку и заставить поиск работать молниеносно. Рассказываю, как мы это «приготовили» в СОФТОНИТ. Главная идея Docs-as-Code: документация лежит рядом с кодом, мы пишем код, обновляем документацию и клиенты видят обновленную документацию на сайте без танцев с бубном...

В прошлой части я рассказывал, как наша база знаний на Битриксе превратилась в источник головной боли. Неудобный редактор, квесты с загрузкой картинок и, главное, полный рассинхрон документации с кодом. Терпеть это дальше было нельзя. Решение принято — переезжаем на Docs-as-Code. Остался «пустяк»: выбрать движок, на котором всё это будет работать. И тут начинается самое интересное. TL;DR для тех, у кого нет времени: ❗️ Задача: Найти быстрый и удобный генератор статических сайтов с мощным поиском, чтобы клиенты и сотрудники не страдали...

Меня беспокоит наша база знаний с документацией по нашему ПО на сайте. Она выглядит не особо и содержит ряд фундаментальных проблем, которые портят жизнь как разработчикам, так и пользователям. Сайт Софтонит сделан на Битрикс, и изначально мы выбрали встроенный в эту платформу механизм для создания базы знаний. Это было в 2016 году, и на тот момент казалось, что всё выглядит хорошо и в целом всё удобно и классно. Надо зайти и изменить статью? Открываешь админку сайта, заливаешь картинки, добавляешь текст статьи на сайте, и она сразу же отображается для клиентов...