на едущую автонумерацию тоже неудобно. Как лучше то?

Почему?

Ссылаются обычно до уровня "абзаца". Ссылка на предложение уже опциональна.

В "американском" стандарте нумеруются просто каждая строка и сослаться можно просто на строку.

В документе, который никогда не будет меняться, нумеровать строки (и вообще что угодно) нормально, конечно.

Мне кстати докопс зашло как практика документации открытой организации

Привет, коллеги! Консультирует и кто-нибудь из вас по Sphinx, Latex и/или может разработать шаблон Latex на платной основе? Вариант "изучить самостоятельно" я не рассматриваю, т.к. уже потратила непозволительно много времени и рабочую схему пока не получила.

очень хороший вопрос. Мне потребовалось немало времени чтобы убедить помочь мне (не бесплатно конечно) =)

Но вариантов нет, надо туда, если не хочется присоединиться к кучерам

в подобных случаях лучше куда-нибудь выложить что именно вы хотите добиться и что получаете вместо этого. Потому что за фразой не получается может скрываться одно строка исправления, а может целый цирк с жонглирующими клоунами на медведях. Иногда просто переформулировать задачу уменьшает объем работы на порядок.

Пока состояние - стандартный шаблон latex и я мало понимаю как из этого получить документ близкий к фирменному стилю с системными шрифтами. Ну и + не хватает информации, чтобы выстроить корректно всю последовательность работы

может на хабр.фриланс создать заказ?

Вам нужно или искать специалиста по ТЗ, или искать внутри компании, или менять инструмент, если не можете его обслуживать, так как поддержка будет требоваться все равно

В целом там до какого-то момента легко разобраться, у меня сейчас не закрыты только задачи i18n и переключения версий доков на лету

Коллеги, а на каком уровне требований к оформлению документации перестаёт хватать docxbuilder и нужен latex?

Вы почувствуете

На самом деле MS Word достаточно хорошо оформляет текст. Проблема скорее техническая. MS Word не поддерживает CI. Значит нужны внешние средства с той или иной степенью приближению. А это уже болото

https://github.com/CourseOrchestra/asciidoctor-open-document попробуйте вот этот проект. Там используется LibreOffice

Оформляет может и хорошо, но шрифты, верстка итп - некрасивые

Кстати, про CI - не вижу проблемы особой, это ж xml

Чем вы пользуетесь в TeX, но этого нет в MS Word (если оставить за скобками то, что в MS Word легко сделать плохо)? В данном случае важно, что сам документ делается НЕ в MS Word. Т.е. неудобство работы с самим MS Word мы не учитываем. Самой серьезной проблемой я всегда считал кернинг. Но, сейчас, вроде, здесь всё в порядке.

Касательно CI. Если мы выпускаем любой документ, то необходимо, как минимум, обновить поля. Например, номера страниц в содержании. Для этого документ надо отрендерить. Лучше всего это делает MS Word. Заметно хуже Libre Office. Есть еще xsl-fo вариант и аналогичные. Все не тестировал, но предварительно там можно искать решения для очень узких задач.

Вариант без боли -- только MS Word. Он не противоречит CI. Но мы же за лёгкость, за эффективность.