При желании можно даже соединить эту связку с confluence, кстати. Sky is the limit, как говорится.

Спасибо.

Но это все есть и в Sphinx+rST. И еще популярность ×10. Но если люди хотят конфлюенс, то это замена шила на мыло.

Дальше надо копать, искать настоящие потребности и страхи

Sphinx+rst сложнее и порог входа выше, соответственно. Но тоже хорошо.

Имхо, конечно же. Я много чего изучил, но выбор остановил именно на анторе

Оба инструмента — классные. Но мне кажется, что тут проблема может быть вообще не в плоскости инструмента. Люди обычно не говорят вот так сходу настоящую причину недовольства. А пока мы её не знаем, мы действуем вслепую.

Предположим, автор вопроса потратит несколько месяцев, переведёт всех на Антору, команда скажет: «»не нравится разметка AsciiDoc, хотим в Confluence, там интерфейс приятный и само вжух делается». И что тогда делать?

Внедрение новых инструментов и процессов — это задача почти целиком про людей и только слегка про инструменты.

Во-первых нужно показать демо. Решить, нравится или нет. Во-вторых, UI Анторы можно настроить под себя. В-третьих, наверняка UI сфинкса тоже можно. В-четвёртых, любой инструмент можно настроить, чтобы вжух и само разворачивалось. Мы настроили Антору через тимсити. Кто-то через gulp делает и т.д. Предполагаю, что сфинкс как минимум не хуже в этом.

Да-да, со всем согласен. Автоматизируется всё очень классно.

А что бы вы показывали на демо команде писателей, которая хочет поменять инструменты?

свернуть в окно немного суицидально звучит

Много плюсов. Истинно так.

Автору вопроса можно порекомендовать повести исследование пользовательского спроса на своей фокус-группе. А то очень много труда может дать лишь одно разочарование, потому что покажется, что получили всё то, что имели, с видом сбоку.

это пятничный тлен
пятничный
тлен

Я просто представить планирую Антору и адок. Ничего особенного, просто практикум, насколько это легко. Я ещё говорил про статью, вот в статье я задокументировал весь путь с муками выбора нового формата документации. Это что-то типа обзора SSG сначала, а потом уже про настойку Анторы и конвертацию документации в адок из диты.

пусть попробуют продавать без документации, с 50% скидкой. За счёт снижения цены увеличатся объёмы продаж больше чем в два раза. Профит

тленовый сироп

а скажите, стоит ли EdrawMax LifeTime своих 17 тыс. руб?

пожизненные лицензии хорошо мотивируют

Привет. А что за статья?

У нас в компании была документация в DITA и маркдавн. Однажды мы решили обновить её, поручили мне заняться этим. Я думал, что да как, надумал, выбрал Antora + Asciidoc. Все шаги записал, чтобы поделиться, как я проводил исследования и к чему присматривался. Оформил всё в статью в двух частях - первая про поиски, вторую про настойку найденного. Первая часть уже готова, нужно только опубликовать, в понедельник опубликую, дам ссылку.

о. а это я бы с удовольствием почитал)) буду тоже ждать ссылку