Как закалялась документация

[terein]

Со скринами "как было" и "как стало" было бы понятней стоит ли игра свеч или нет. Можете пошарить?

[InstaHeat]

в смысле - вордовые документы и вики?

[terein]

Да, и переходы на разделы wiki из продукта

[InstaHeat]

Могу лишь намёками показать. Сфинкс в стоке выглядел примерно так.

Я его доработал до такого состояния:

В продукте кнопка выглядит так:

Ничего особенного, обычная кнопка-ссылка, которая для каждого экрана своя, что и позволяет переходить адресно. Кнопка находится на правой части экрана и вылезает при наведении. Не торчит, как могло бы показаться))

[terein]

А описание решений где ведёте? Если нужно в нескольких местах продукта выполнить синхронные настройки, например.

[InstaHeat]

У нас есть руководство по настройке. Как правило, если что-то подобное есть, то всё хранится отдельной инструкцией в этом руководстве. Но вообще, если говорить по хорошему, нужно А) улучшать нашу документацию в этом плане, Б) стараться избегать таких решений в продукте

[InstaHeat]

Много времени заняла доработка? И, я так понял, у вас нет необходимости генерить pdf?

[fiddle-de-dee]

Справедливости ради, Asciidoctor поддерживает, как минимум, 5 pdf-ориентированных технологий. Для разных случаев от генерации ГОСТовской документации до создании дизайнерских листовок. Поэтому экстравагантные решения типа HTML->PDF, возможно, излишни. Хотя... всякое бывает

Подскажите, пожалуйста, чем пользовались для публикации в Confluence?