Набор?

Технологий

Docops в разных окружения бывает

Sphinx, деплоим на сайт под Django, CI на GitHub Actions

Спасибо. Очень интересно.

На самом деле ревьюить, конечно, можно и исходники и конечные документы, но всё же конечные документы ревьюить важнее. Именно поэтому, для более менее сложной документации, надо уметь её превращать в "ревьюбельный" формат. Microsoft Word или Libre Office, статический сайт с возможностью делать Issue или PR. Возможно, есть другие варианты. Раньше нравился pdf, но не очень удобно оказалось

Коллеги, когда над документами работает несколько авторов — как вы добиваетесь соблюдения глоссария?
Используете ли какую-то автоматику или глазками отсматриваете? Если глазками — есть ли какие-то выстраданные лайфхайки, которые лучше знать? )

Мы когда делали большие документы в Латехе, то на проект был один общий словарь сокращений. И человек, соответственно, может использовать сокращения только из него.

А в самом словаре сокращений хорошо видно возможные дубликаты и нестыковки.

Пример, может, не совсем релевантный.

Мы занимались word sense disambiguation если хочется про автоматику и в embeding пространстве зачастую можно синонимы пообнаруживать, но задача оч сложная для автоматизации, проще пойти от white/black листа ИМХО. Методы табуирования каких-то вызывающих споры слов неплохо работает.

латех это как-то автоматизирует или все были такие ответственные?

blacklist звучит топорно, эффективно и интересно ^_^

Ну например для медицины ГБ должно быть запрещено , потому что существуют 14 разных смыслов этого слова

ГБ по всей России постановлением правительства запрещено

мы все ставили Vale (https://docs.errata.ai/vale/about/) и экстеншен VSC. С ним можно проверять согласно стилям MS, Google и проч + мы добавляли свои выражения в word list. Тогда при "неправильной" форме показывается ворнинг с рекомендацией как надо

Есть проект, в рамках которого требуется разработать кучу текстовых документов разными авторами.

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

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

Человек может использовать левое сокращение и не включить его в перечень сокращений. Мы это не автоматизировали, но регулярками можно найти в принципе.

спасибо за пояснения

Коллеги по сфинксу, помогите, пжлст.

Ситуация такая. Сейчас есть десяток репозиториев с проектами. И самописная тема.
Лэйаут, стайлшиты и опшны — общие для всех. На уровне проекта определяются только лого, цвета и иконки.
Сейчас тема раскопирована во все эти проекты. Поддерживать это, ясен Красин, больно.
Есть ли какой-то способ вынести общие части темы в единый источник, в идеале, в отдельный репозиторий, и инклюдить в проекты?

Не пробовала, но интересно. Стековерфлоу пишет что-то такое: https://stackoverflow.com/questions/7621086/synchronization-of-several-remote-git-repositories  - и там второй вариант с хуками выглядит перспективным.

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

в какой формат?