пошёл читать, что такое синопсис

Все хорошие техписы в той или иной мере обучены и кодить и конфиги писать. Это и отличает высокооплачиваемого специалиста от среднего или начального уровня.
Я думаю никто, в текущих реалиях, не будет платить техпису хорошие деньги если он просто набирает текст.
Например, техпис обязан сам развернуть среду разработки документации на основе сфинкса+рст; иметь и знать вывод через апач-фоп и тд и тп
Но! Вот просто жирный но, который я всегда приношу в такого рода обсуждения, применимое в условиях России. И связано это Но с тем, что даже крупные ИТ-компании вынуждены писать документацию или согласно ГОСТ или валидируя в ФСТЭК.
А такой подход не предполагает использование подхода к документации как к сервису или коду ,а значит от технического писателя требуются уже другие компетенции, и ему совершенно не нужно уметь в докер; зато вот знать ФТБ или РВ более полезно.
Что же касается доли именно госдокументации - она огромна. Яндекс, Маил, Касперский - все пишут доки именно такого плана. Что же говорить о компаниях поменьше.
Зачем компании техпис, который может в docasacode, когда его Изделия надо офрмлять согласно РВ.
))

Все хорошие техписы в той или иной мере обучены и кодить и конфиги писать. Это и отличает высокооплачиваемого специалиста от среднего или начального уровня.
Я думаю никто, в текущих реалиях, не будет платить техпису хорошие деньги если он просто набирает текст.
Например, техпис обязан сам развернуть среду разработки документации на основе сфинкса+рст; иметь и знать вывод через апач-фоп и тд и тп
Но! Вот просто жирный но, который я всегда приношу в такого рода обсуждения, применимое в условиях России. И связано это Но с тем, что даже крупные ИТ-компании вынуждены писать документацию или согласно ГОСТ или валидируя в ФСТЭК.
А такой подход не предполагает использование подхода к документации как к сервису или коду ,а значит от технического писателя требуются уже другие компетенции, и ему совершенно не нужно уметь в докер; зато вот знать ФТБ или РВ более полезно.
Что же касается доли именно госдокументации - она огромна. Яндекс, Маил, Касперский - все пишут доки именно такого плана. Что же говорить о компаниях поменьше.
Зачем компании техпис, который может в docasacode, когда его Изделия надо офрмлять согласно РВ.
))

я тоже
что такое синопсис применительно к техдокументации?

Всегда хотел иметь интегрированную среду под DocOps процесс, но только ради одной фичи: комментарии к версии документа от внешних участников.

Внутри команды, ок, есть merge request'ы в GitLab'е. Но не буду же я каждого мимолётного клиента погружать в свой причудливый тулсет?

У кого-нибудь есть решения, кроме ручной сверки комментариев из .docx/Google Docs с исходником в репозитории?

А вроде есть тулзы для прикручивания комментариев к любой веб-странице с текстом. Что-то я встречал, поищу.