Size: a a a

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

2018 December 25

SK

Sergei Kutcher in DocOps-сообщество
Вот только цена этого вопроса возврастает - сколько там стоит час мидла например?
источник

FM

Fox Mulder in DocOps-сообщество
Хотите еще историю про ЭМ?!  Есть одна компания. Была лидером в своей отрасли. Набрали ЭМ для незнаю чего, хотя они и в Европу зашли и без ЭМ.
Прошло немного времени. Офис компании переехал из центра за глубой заМКАД, ведущие сотрудники поувольнялись, рынок Европы потерян.
Первое распоряжение ЭМ по приходу?! Наладить дисциплину, поставить турникеты, дико штрафовать за опаздание на работу с введением жесткого графика.
Компанию не называю. Но она реально была очень сильной.
источник

FM

Fox Mulder in DocOps-сообщество
Sergei Kutcher
Куда интереснее узнать, кто и как систематизирует базы знаний внутренние?
Confluence
источник

NV

Nick Volynkin in DocOps-сообщество
Fox Mulder
а что делает менеджер в чате разработчиков/технических писателей?
чат не по профессии, а по общим интересам. Для профессии есть @technicalwriters, но и там неоднородный состав.
источник

SK

Sergei Kutcher in DocOps-сообщество
Fox Mulder
Confluence
Да, согласен
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Sergei Kutcher
Есть ли фидбек от новых сотрудников например
Тоже интересно)

Пока при построении руководствуюсь правилом
"Один человек споткнулся — объясни.
Двое — переделай"
источник

SK

Sergei Kutcher in DocOps-сообщество
Это правильнее
источник

FM

Fox Mulder in DocOps-сообщество
Создаем вики-страницы, править которые могут только определенные люди. Большая проблема вычленить что-то полезное и правильное из flow разрабов и тестеров
источник

SK

Sergei Kutcher in DocOps-сообщество
Confluence - это хорошо. Но как приучить туда заглядывать. Тем более тогда, когда им пользовались постольку-поскольку.
источник

FM

Fox Mulder in DocOps-сообщество
Sergei Kutcher
Confluence - это хорошо. Но как приучить туда заглядывать. Тем более тогда, когда им пользовались постольку-поскольку.
У нас постановка задача через Jira, а в джире обычно таски ведут в конфу
источник

SK

Sergei Kutcher in DocOps-сообщество
Собирать крохи по тикетам и ТЗ?
источник

FM

Fox Mulder in DocOps-сообщество
а да, уведомление о новом таске приходит на почту
источник

SK

Sergei Kutcher in DocOps-сообщество
Мне на самом деле интересно, как процесс построен в других командах/компаниях.
источник

SK

Sergei Kutcher in DocOps-сообщество
Например наполнение базы - есть структура, есть разделы/подразделы
источник

SK

Sergei Kutcher in DocOps-сообщество
Как вы уведомляете о новых статьях? Рассылка по юзерам? Пост на главной?
источник

SK

Sergei Kutcher in DocOps-сообщество
Речь идет о Confluence
источник

L

Lana in DocOps-сообщество
Sergei Kutcher
Куда интереснее узнать, кто и как систематизирует базы знаний внутренние?
Мы храним в репозитории рядом с соответствующим модулем, выгружаем by Sphinx в confluence, при обновлении кода на ревью проверяется обновили ли документацию как техническую, так и процесснуб

Также ее можно себе локально собрать в html кому удобно
источник

FM

Fox Mulder in DocOps-сообщество
Sergei Kutcher
Мне на самом деле интересно, как процесс построен в других командах/компаниях.
У нас очень много workflow, так как каждое направление имеет свою базу. Мы, как ТП, вычленяем необходимое по документации. Есть еще раздел с read-привелегией. где write Только у менеджера продуктов. Как таковых шаблонов и стандарта написания в конфе у нас нет. Чем еще у нас тяжело - у нас активно используется OpenSource и много пуулреквестов идет от сообщества. А там люди часто даже не комментят
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Sergei Kutcher
Confluence - это хорошо. Но как приучить туда заглядывать. Тем более тогда, когда им пользовались постольку-поскольку.
Туда привыкнут заглядывать, если там легко находить ответ на вопрос

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

В порядке эксперимента начал SEO'шить страницы _внутренней_ документации и заметок.
Как минимум я стал чаще ими пользоваться, засчёт того, что поиск по ним даёт мне ответ 🙂

Надо бы анкетку по команде запульнуть, поспрашивать
источник

I

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