Это не так. Я бы даже написал - абсолютно не так и этот текст просто грязный поклёп! + полное не понимание того что спрашивают на en-форумах и как спрашивают.
Я всегда в вопросе указываю достаточную для первоначального анализа информацию. Если что-то не будет понятно - привожу еще.
Что же касается "товарищ не читает документацию" - вообще полный абсурд.
==
Тем более, хочу напомнить, что технический писатель - в первую очередь про тексты. Ни 1 ПМ или Заказчику все эти md или adoc с генераторами не нужны. Им нужны тексты. От техписа.
И если я начальнику скажу, что не написал док потому что разбирался в бутстрапе, то меня уволят.
И будут правы.
Потому что поднимать инфраструктуру - это к девопсам,  поднимать визуальный стиль и логику сайта - к фронтам.
И никак иначе. Ибо иначе дойдет до того. что техпис, чтобы задать вопрос в этот чат должен стать сеньором java, тогда товарищ нац-нац позволит разрешить задать вопрос.
Это маразм!
==
Вообщем, я задавать вопросы в этот паблик не буду, читать буду, но не спрашивать.
Пусть его величество нац нац тут правит.

Граждане, кто-то в последнее время докуменитровал API на каком-нибудь SSG? Не подскажите какую тему использовали или какую взять/рассмотреть лучше/проще на ваш взгляд?

Можно еще попробовать slate. Он не на jekyll, а на middleman, ну хоть ruby лишний раз ставить не надо.

@Nick_Volynkin, а вы с redoc не сталкивались с ситуацией, когда несколько файлов со спецификацией api. Получается на каждый файл отдельный инстанс redoc-а? Или я не разобралась еще?

Это не так. Я бы даже написал - абсолютно не так и этот текст просто грязный поклёп! + полное не понимание того что спрашивают на en-форумах и как спрашивают.
Я всегда в вопросе указываю достаточную для первоначального анализа информацию. Если что-то не будет понятно - привожу еще.
Что же касается "товарищ не читает документацию" - вообще полный абсурд.
==
Тем более, хочу напомнить, что технический писатель - в первую очередь про тексты. Ни 1 ПМ или Заказчику все эти md или adoc с генераторами не нужны. Им нужны тексты. От техписа.
И если я начальнику скажу, что не написал док потому что разбирался в бутстрапе, то меня уволят.
И будут правы.
Потому что поднимать инфраструктуру - это к девопсам,  поднимать визуальный стиль и логику сайта - к фронтам.
И никак иначе. Ибо иначе дойдет до того. что техпис, чтобы задать вопрос в этот чат должен стать сеньором java, тогда товарищ нац-нац позволит разрешить задать вопрос.
Это маразм!
==
Вообщем, я задавать вопросы в этот паблик не буду, читать буду, но не спрашивать.
Пусть его величество нац нац тут правит.

> Ни 1 ПМ или Заказчику все эти md или adoc с генераторами не нужны.

Враки. Я ПМ, мне нужны =)
Точнее я понимаю ценность технологии и как она отразится на моих проектах. Поэтому выделяю ресурсы и разбираюсь сам. У меня над изменением подхода к документированию работает не только техпис, но и несколько других ребят: фронт, девопс, фулстек.

Я к тому, что у тебя есть желание изменить подход к документированию, но ты пытаешься всё делать сам, в одно жало. Попробуй донести ценность инструмента до своих руководителей, чтобы тебе выделили ресурсы для помощи в преодолении технических трудностей. Покажи плюсы инструмента, как он изменит вашу рабочую систему, что станет лучше, быстрее, качественнее и я уверен, что тебе тут же найдут помощника.

Ценность подхода docs-as-code понимает аналитик, еще девопс.
Заказчики хотят word и ничего кроме ворда.
Менеджменту всё равно какая платформа и какие инструменты используются - важен результат.
Есть ворд для заказчиков и есть Confluence для хранения контента.
Остальное - опционально в своё свободное время.
==
Мы, с аналитиком, потихоньку меняем парадигму. Надеюсь преобладаем.

А в чем ценность для вас? Как ты видишь эту ценность? Зачем вам нужен doc-as-code?