Size: a a a

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

2018 December 25

SK

Sergei Kutcher in DocOps-сообщество
Igor
У нас раз в месяц рассылка "Что нового в нашей документации", и эти сводки подшиваются на страничку в конфлю
Хмм, информация не успевает устареть? Ведь если микросервис, то в проде продукт может измениться за неделю
источник

FM

Fox Mulder in DocOps-сообщество
Igor
У нас раз в месяц рассылка "Что нового в нашей документации", и эти сводки подшиваются на страничку в конфлю
Обычно в конфе можно указать что добавилось, заоодно и просмотреть старые версии
источник

FM

Fox Mulder in DocOps-сообщество
Кстати, есть кто в OxygenXML работает? Можно приватом
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Igor
У нас раз в месяц рассылка "Что нового в нашей документации", и эти сводки подшиваются на страничку в конфлю
Интересно, как проводите анализ, какой результат даёт рассылка?
источник

FM

Fox Mulder in DocOps-сообщество
Vadim Smelyanskiy
Интересно, как проводите анализ, какой результат даёт рассылка?
А он нужен?
источник

SK

Sergei Kutcher in DocOps-сообщество
Хотя нет, не верный пример - есть тикет, есть проблема, есть описание. Но, если апдейт раз в месяц, а проблема решена - не будет ли избыточной такая раасылка? Актуальность страдает?
источник

SK

Sergei Kutcher in DocOps-сообщество
Fox Mulder
А он нужен?
А почему нет? Фидбек разве бывает лишний?
источник

I

Igor in DocOps-сообщество
Sergei Kutcher
Хмм, информация не успевает устареть? Ведь если микросервис, то в проде продукт может измениться за неделю
Ну нет, то что в проде за это время сильно не поменяется. Даже микросервис. Критичные вещи всё равно через стандартные процессы code review проходят.
У нас ещё рассылка по апдейтам "какая команда что сделала" раз в две недели, там если что можно подсмотреть.
источник

I

Igor in DocOps-сообщество
Vadim Smelyanskiy
Интересно, как проводите анализ, какой результат даёт рассылка?
¯\_(ツ)_/¯ Думаю никак
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Fox Mulder
А он нужен?
На рассылку тратится ресурс компании

К примеру, если её не читают, это проблема
источник

FM

Fox Mulder in DocOps-сообщество
Вот смотрите. Есть код с функционалом, разработчики его правят, делают таски. Зачем драфтовые ченджи нужны? Когда будет доступно, тимлид сделает паблик новой версии. Мы возьмем оттуда ченджлист и добавим
источник

I

Igor in DocOps-сообщество
Sergei Kutcher
Хотя нет, не верный пример - есть тикет, есть проблема, есть описание. Но, если апдейт раз в месяц, а проблема решена - не будет ли избыточной такая раасылка? Актуальность страдает?
Ммм... Мы наверное про разные вещи.
В такую рассылку не всё подряд попадает, а только hand-made документация
источник

I

Igor in DocOps-сообщество
Типа там уровня "архитектура нашей системы X"
источник

FM

Fox Mulder in DocOps-сообщество
Имхо, мало кто читает такую рассылку, если она не соответствует должностным обязаностям
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Больше философский вопрос: почему возник вопрос о базе знаний? О том как заставить туда заглядывать и тд? @daskain
источник

FM

Fox Mulder in DocOps-сообщество
Anastasia Prokopyeva
Больше философский вопрос: почему возник вопрос о базе знаний? О том как заставить туда заглядывать и тд? @daskain
База знаний, кто должен следить за ее актуальностью? ПМ или ТП?
источник

I

Igor in DocOps-сообщество
Fox Mulder
Имхо, мало кто читает такую рассылку, если она не соответствует должностным обязаностям
у нас все читают, судя по обсуждениям
её пишут клёвые люди :)
источник

SK

Sergei Kutcher in DocOps-сообщество
Anastasia Prokopyeva
Больше философский вопрос: почему возник вопрос о базе знаний? О том как заставить туда заглядывать и тд? @daskain
Возник вопрос, потому что задавать вопрос разработчикам - это дорого
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Как бы плясать нужно от печки: от потребностей и целей. У нас все читают конфлюенс, никого не надо заставлять.
источник

AP

Anastasia Prokopyeva in DocOps-сообщество
Sergei Kutcher
Возник вопрос, потому что задавать вопрос разработчикам - это дорого
Задавать вопросы разрабам придется, потому что как реализовано знают только они. Либо просто научиться читать код
источник