Как мы избавились от копипаста в технической документации

[TimurZhoraev]

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

[jvw]

Интересная штука. Хотел потыкать, но у вас регистрация только по приглашениям. Судя по описанию и скринам интерфейса (здесь и у вас на сайте), я бы сказал, вашей системе недостаёт векторного поиска. Полезная штука, когда документации много и коррелирует с вашими планами - я имею в виду ИИ помощника (RAG)

[orchanin]

А куда вы хотели потыкать? У меня не получилось найти следы самого сервиса в профиле автора и статье.

[jvw]

я по названию нагуглил https://gost-on.ru/

[orchanin]

Слона то я и не заметил)

[NikitaOsokin_ON]

Напишите мне сообщение, я с удовольствием предоставлю демо-доступ)

[d3d12]

Я наверно очевидность скажу - но не проще сюда ИИшку прикрутить, она все и поменяет.

[GorkyUser]

Молодцы, конечно, но есть же такие развитые технологии как Docbook и DITA и есть XML-редакторы их поддерживающие, например, oXygen XML Editor. Поддерживается:
1. Принцип единого источника. Документ в Oxygen можно собирать из "кирпичиков" – из разных текстов, хранящихся в других файлах.
2. Профилирование. Блоки данных можно помечать специальными атрибутами, которые отвечают за публикацию документа в той или иной интерпретации. Перед публикацией отмечается нужная интерпретация и какие-то блоки печатаются, а какие-то, не относящиеся к этой интерпретации, игнорируются.
3. Отделение оформления от содержания. Писатель работает только с содержанием и разметкой. Стили форматирования элементов разметки прописаны в других файлах и после настройки не меняются.
4. Многоформатность. Публикация возможно в различные форматы (PDF, Word, HTML...).
Самое сложное будет, особенно с необходимостью писать по ГОСТу настроить стили в п.3. А потом все идет как по маслу.

[NikitaOsokin_ON]

Именно в случае ГОСТа самым тяжелым оказалось решить вопрос правильного рендеринга DOCX и из него впоследствии PDF. Вся ГОСТ с документация с "рамками" это прям оформительская боль, так как это оформляется в логике Word как колонтитул, далее используются разные форматы колотитулов для титульного листа, оглавления и основной части + элементы переменных внутри колонтитулов. То есть все что мы пробовали приводила к получению полуфабрикатных документов, которые все равно приходилось дополнительно форматировать руками. Надеюс в отдельной статье чуть больше технической деталей опишу, как мы в итог это решили + еще заложили вариативность, что можно свободно менять форматирование при генерации (например в ГОСТе 2 шрифта допустимы: Times New Roman и GOST).

И еще нам стало очень удобно подключать ИИ-ассистента, когда это свое решение, то больше есть поле для экспериментов с этим. В перспектие дойдем до своего MCP.