Коллеги, работающие по Docs-As-Code подскажите, пожалуйста, названия инструментов
- в которых вы готовите тексты до гитлаба
- в которые релизите текст после гитлаба (статический  сайт)?

VSCode, релизим в самом гитлабе с помощью его родного CI в кубер статический сайт

Сравнивали, выбирали или исторически сложилось?

Что?

Инструменты.

Простота и прелесть докс аз кода в том, что можно использовать то, что используется в компании уже без доп костов существенных, поэтому мы просто взяли то, что уже настроено под задачи разработки, если речь про гитлаб ci

Спасибо!

Код новой документации пишу в IntelliJ с плагином AsciiDoc. Не могу нарадоваться. Прежняя документация в формате DITA делалась (и поддерживается всё ещё) в Oxygen XML. Поддерживать диту не так удобно и приятно как аскидок.

Сайт из диты при помощи кастомных xslt трансформаций создавался. Точнее, не сайт, а html файлы, которые потом выкладывались вручную. Из аскидок Антора сама всё делает. Мы только автоматизировали сборку через тимсити. Могу прислать ссылки, если хочется посмотреть. В моб райтинг я тоже доклад делал, немного показывал про Антору.

Раньше были Программисты, не то что сейчас.

Спасибо!
Доклад смотрел - круто!

отправила маме, которая вот как раз похожие вещи про свою молодость программистскую рассказывала ) правда, она оттуда ушла, когда отладка в ужасах стала сниться каждую ночь)

Если можно, пришлите ссылку или принтскрин. Интересно посмотреть, как выглядит ваш конечный статический сайт с документацией.

Балин, сейчас бы мемесы не в тот чат писателей скинуть:D

Хороший мемес, есть что почитать!

Испытательный стенд, испытательная установка

@DanilMamontov Там особенно не на что смотреть, всё идентично сайту Antora docs. https://docs.antora.org/, только что на русском. Исходники можно глянуть на гитлабе: https://gitlab.com/antora/antora/-/tree/main/docs Или любую страницу - тыкнуть на "Edit this page".

Спасибо.

Всем добрый день!

Подскажите, пожалуйста, нужно ли переводить расшифровку сокращения, указанного в перечне сокращений документа? Информации в ГОСТах не нашла..