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

Те девопс - это как фитнесс, им можно заниматься, но нельзя себя им называть.

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

А в итоге обычных админов переименовали в девопсов и скорректировали им зарплаты.

Тем временем, чат перевалил за 600 человек.
Коллеги, расскажите о себе? Чем вы занимаетесь, что вас сюда привело?

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

А что вы хотите чтобы «девопсы» писали в документ?

Тем временем, чат перевалил за 600 человек.
Коллеги, расскажите о себе? Чем вы занимаетесь, что вас сюда привело?

как настроить инфраструктуру, задеплоить приложение, где найти логи, как реагировать на алерты

Станислав, работаю на mcs.mail.ru и пишу про Cloud и IoT.  Markdown + hugo + G.docs + docx. В общем зоопарк форматов и всё зависит от ЦА.

почитываю твои тексты!

Привет) Я Юля, техрайтер финтех стартапа, пишу внешнюю доку для клиентов и редактирую/структурирую/дописываю внутреннюю. А ещё делаю переводы (eng -> ru/ukr) и правлю тексты внутри продукта, т.к. на чуть-чуть ещё локализатор и ux-райтер))) Инструменты: md, html, json, git, static site generators (mkdocs) и confluence. В чатах пишу мало, но читаю обсуждения и таскаю полезные ссылки (и не успеваю потом читать большую часть, прям киберплюшкин 😄)

Иван, 3 года техрайтер. Работаю в основном с MadCap Flare + Git. Ну и Confluence. Интересуюсь SSG, но больше для себя, чем на рабочих проектах. Работаю сейчас в EPAM. Сюда прихожу за сведениями о SSG, как люди это используют на практике. Пока я не убежден, что SSG лучше и проще, чем HAT.

Максим, Static Site Generators and Help Authoring Tools. Первые это Hugo, MkDocs и многие другие. Второе это MadCap Flare, Robohelp и многие другие. Первые позиционируются как современная и бесплатная альтернатива дорогостоящим решениям вторых. Годовая лицензия MadCap Flare стоит 1700 долларов, если не ошибаюсь.

Максим, Static Site Generators and Help Authoring Tools. Первые это Hugo, MkDocs и многие другие. Второе это MadCap Flare, Robohelp и многие другие. Первые позиционируются как современная и бесплатная альтернатива дорогостоящим решениям вторых. Годовая лицензия MadCap Flare стоит 1700 долларов, если не ошибаюсь.

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