Они десятилетиями писали в старых инструментах

Не удивлюсь, если выяснится, что некоторые ещё помнят COBOL.

Жена ездила в голландию на слёт dita техрайтеров. Там много было как европецев, так и американцев. Все в возрасте. Все исповедуют docs as  code

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

И не везде они нужны эти новые инструменты, эта документация в коде

На конференции ездят с другими целями. :)

Многим нужны просто пдфки, сделанные из Ворда

На сегодняшний день, так и есть.

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

Мы сами продвигаем эти ссг в массы. Рассказываем руководству, как это просто и красиво

На чём оно основывается?

Но пдф документация и инструменты типа MadCap Flare ещё долго не отомрут

Если просто и красиво, то не одобрят. Им надо говорить насколько это выгоднее и дешевле текущих решений и соответственно сколько они смогут срезать бабла себе. :)

ну из рационального подхода - проще контент держать в сети

Никого не защищаю и не оправдываю, тем более наличие печатных мануалов.
Первое, что в голову пришло по поводу контента в сети:
— наличие постоянного доступа в интернет;
— очень желательно иметь контроль над ресурсом, где выложен материал.
Оба момента необходимо учитывать.

Один фиг, всякие бумажные мануалы на технику не в ворде делаются

Хотел поделиться: мы в флюссонике начали имплементить такую идею, чтобы склеить тесты и документацию.

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

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

Это первый шаг из нашего списка:

1. сделать тестируемыми примеры конфига (мы здесь)
2. сделать тестируемыми примеры вызовов курла и прочих подобных утилит
3. сделать генерируемыми скриншоты
4. сделать детекцию сильного изменения скриншотов, нет ли багов
5. автогенерировать видеоскринкасты из записи прогона тестов (селениум)

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

Мы уже из документации выгружаем json, который вставляется в реакт-вебморду в нужных местах для нажатия на вопросик «что это за кнопка»

Толково.

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