Size: a a a

DocOps-сообщество

2020 February 21

EN

Ekaterina Noskova in DocOps-сообщество
^__^
источник

NV

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

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

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

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

А

Александр Мокрушин in DocOps-сообщество
Nick Volynkin
Тем временем, чат перевалил за 600 человек.
Коллеги, расскажите о себе? Чем вы занимаетесь, что вас сюда привело?
Всем привет!
Меня зовут Саша, я работаю техническим писателем 8 лет. Я занимался разработкой документации для ECM-системы Directum. Последние пару лет участвую в проектах заказной разработки.
Как-то увидел несколько докладов про docs as code и Foliant, захотел познакомиться с новыми для себя инструментами и внедрить их у себя. Чат в этом очень помогает)
источник

ML

Maksim Lapshin in DocOps-сообщество
Hanna Khyzhnia
согласна с вами, поэтому сейчас появилась цель заставить девопсов самих писать документ, потому что лучше них никто не знает проект, а моя задача просто красиво оформить в человеческий вид и сделать читабельно и понятно.
А что вы хотите чтобы «девопсы» писали в документ?
источник

HK

Hanna Khyzhnia in DocOps-сообщество
Maksim Lapshin
А что вы хотите чтобы «девопсы» писали в документ?
как настроить инфраструктуру, задеплоить приложение, где найти логи, как реагировать на алерты
источник

AL

Artemy Lomov in DocOps-сообщество
Nick Volynkin
Тем временем, чат перевалил за 600 человек.
Коллеги, расскажите о себе? Чем вы занимаетесь, что вас сюда привело?
Привет, я Артемий, работаю в «Ростелеком ИТ». По факту чаще в качестве DocOps, реже в качестве техписа (архитектурные всякие штуки документирую). Один из разработчиков Фолианта. Сюда пишу редко, но почти все читаю.
источник

ML

Maksim Lapshin in DocOps-сообщество
Hanna Khyzhnia
как настроить инфраструктуру, задеплоить приложение, где найти логи, как реагировать на алерты
Вся суть концепции девопс в том, чтобы не было документов описывающих деплой приложения, потому что эти документы заведомо неточны и устаревшие :)

Вместо этого программисты и именно они пишут код который деплоит. Код на каждый чих гоняется в ci и тем самым обеспечивается его стабильность.


Если этим заняты не программисты, то это антидевопс
источник

FM

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

KC

Kseniya Chudakova in DocOps-сообщество
Fox Mulder
Станислав, работаю на mcs.mail.ru и пишу про Cloud и IoT.  Markdown + hugo + G.docs + docx. В общем зоопарк форматов и всё зависит от ЦА.
почитываю твои тексты!
источник

FM

Fox Mulder in DocOps-сообщество
Kseniya Chudakova
почитываю твои тексты!
источник

YK

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

НФ

Никита Фомичев in DocOps-сообщество
Привет, Никита, технический писатель. Использую Sphinx + reST + gettext + git + docx. Зоопарк наподобие @Stanislav_techwriter
источник

A

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

прям про меня))

я техпис 15 лет уже, начинала с Latex, потом DocBook и xml, потом лет 5 треш гостухи, дальше DITA, сейчас sphinx+rst+localize
источник
2020 February 22

IC

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

ML

Maksim Lapshin in DocOps-сообщество
Ivan Cheban
Иван, 3 года техрайтер. Работаю в основном с MadCap Flare + Git. Ну и Confluence. Интересуюсь SSG, но больше для себя, чем на рабочих проектах. Работаю сейчас в EPAM. Сюда прихожу за сведениями о SSG, как люди это используют на практике. Пока я не убежден, что SSG лучше и проще, чем HAT.
А для неграмотных можно пояснить что такое ssg и почему он должен быть лучше hat?
источник

IC

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

ML

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

A

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

IC

Ivan Cheban in DocOps-сообщество
Анжела, не совсем так. Learning curve для MadCap Flare достаточно долгая. Если нужно заморочиться со стилями CSS или настроить кастомную нумерацию. И никто не мешает применять навыки фронта: вон наша коллега Ярослава создала Java скрипты для MadCap Flare (кнопочки для переключения между версиями для десктоп и мобайл, разными релизами).
источник

H

Hartmann in DocOps-сообщество
Angela
первое требует некоторых скиллов во фронт разработке, или желания их освоить, второе не требует ничего, кроме написания документации и немного времени разобраться с интерфейсом
Так уж и ничего? :) А как же $2к? А ничего, что тот же Mad, Robo и еже с ними работают только на винде, за $2к-то, не? Норм? :)
То есть, если ты macOS пользователь, то или пошёл вон, или ставь винду, или где.
источник