Нужны умные инклюды )

А если это инфраструктурный код или SQL, то тестирование становится очень интересным

Но, наверное, и с этим можно справиться )

Та же DITA их поддерживает, и примеры кода вполне живут отдельно.
Можно даже одним файлом. Но оказалось не слишком удобно, много мороки с выставлением начала и конца инклюда. Или все едет, как только строк больше становится.

А внутри XML как их тестировать?

А вот это я еще только буду думать, как делать.

👋

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

... обеспечивающий код
'tag::esnc[]
c1 --() i1
c2 --( i1
'end::esnc[]
... обеспечивающий код

Апостроф в PlantUML -- это символ комментария.

И далее при включении в документ используется такой синтаксис:

[source]
----
include::example.pu[tags=esnc]
----
image::example.png[]

Т.е. мы получаем исходный код и картинку.

Естественно, перед сборкой документа диаграммы компилировались. Для PlantUML -- это ключевой тест. Но если бы это был не PlantUML'ный код, вполне можно было бы навесить на него тесты.

Эта тема актуальна и будет такой ещё долго )

Привет! Мы тут любим новичков и просим их рассказать о себе :)

и тебе привет!

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

так мы вам все тут и рассказали :-Р

Внатуре, как голым себя почувствовал

Привет! А хешик надо какой ставить?)

#о_себе Я - архитектор/тимлид/системный аналитик на 4х проектах в одном крупном операторе связи (точнее его дочке-подрядчике). Собственно, одна из моих задач - внедрение процессов по заведению и поддержке в актуальном состоянии тех документации по проектам, включая архитектуру самих систем, интеграционное взаимодействие и описание внутренней реализации. Что-то веду непосредственно я, что-то - даю примеры или шаблоны для разработчиков и аналитиков.

Добро пожаловать. Хешик пока не придумали, а пора бы )

#о_себе ?)

А направили меня сюда вот с этим вопросом

Про кухню я пишу в @docops )