Создание системы документирования, или как в Cloud.ru от «ворда» к docs as code за месяц переходили. Часть 2

Юра, спасибо большое за статью, было очень интересно читать эдакий process journey.

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

Если сможешь, поправь, пожалуйста, запятую, опосля **стал**.

Еще такой вопрос, почему был выбран именно RST, а не asciidoc в качестве формата?

Синдром хронического помешательства среди технических писателей

Это скрытый, пятый синдром -- ПостиФигнизм.

Синдром хронического помешательства среди технических писателей

Краткость — сестра таланта!

Да и не рассчитана эта статья на лонгрид. Скорее глянуть под булочку )

Создание системы документирования, или как мы от «ворда» к docs as code за месяц переходили

Хорошо, что не связались с DITA: очень высокий порог входа, серьёзные ограничения на бесплатных сопроцессорах (apache-fop) и как по мне - низкая скорость работы.

Новая документация Docsvision ч. 2 — Antora

Спасибо большое, было интересно.

Мы сейчас идём аналогичным путём и разрабатываем UI в отрыве от дефолтного стиля.

И это не так и просто )