Size: a a a

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

2019 July 13

FM

Fox Mulder in DocOps-сообщество
Anna P
Выглядит, конечно, откровенно плохо, сам интерфейс тоже из казённых нулевых.))
Но написано такими простыми фразами и все наглядно, соответственно (предполагаю) техническому уровню пользователей. Это круто.
Именно так и нужно писать: просто и наглядно.
Глупо думать, что тот, кто читает документацию это бурят Нобелевской премии )
источник

YD

Yuri Dobrev in DocOps-сообщество
бурят Нобелевской премии

задумался...
источник

A

Antonio in DocOps-сообщество
Yuri Dobrev
бурят Нобелевской премии

задумался...
лаубурят)
источник
2019 July 15

L

Lejbron in DocOps-сообщество
Коллеги, хотел бы поделиться с вами своей статьей на тему автоматизации процесса сборки сайта с документацией. Это мой первый опыт как полноценной работы в роли технического писателя, так и в написании подобного рода статей, буду рад критике!
https://habr.com/ru/company/youla/blog/459640/
источник

НН

Нац Нац in DocOps-сообщество
Lejbron
Коллеги, хотел бы поделиться с вами своей статьей на тему автоматизации процесса сборки сайта с документацией. Это мой первый опыт как полноценной работы в роли технического писателя, так и в написании подобного рода статей, буду рад критике!
https://habr.com/ru/company/youla/blog/459640/
чем рисовали диаграмки? =3
источник

SR

Stas Rychkov in DocOps-сообщество
Lejbron
Коллеги, хотел бы поделиться с вами своей статьей на тему автоматизации процесса сборки сайта с документацией. Это мой первый опыт как полноценной работы в роли технического писателя, так и в написании подобного рода статей, буду рад критике!
https://habr.com/ru/company/youla/blog/459640/
Привет, спасибо. А как вы строите коллективную работу по обновлению такой базы знаний? Каждый участник создаёт PR с RST-файлами?
источник

FM

Fox Mulder in DocOps-сообщество
Lejbron
Коллеги, хотел бы поделиться с вами своей статьей на тему автоматизации процесса сборки сайта с документацией. Это мой первый опыт как полноценной работы в роли технического писателя, так и в написании подобного рода статей, буду рад критике!
https://habr.com/ru/company/youla/blog/459640/
А вы поднимали такой сервис в рамках поставленной задачи или в свободное время, выходные?
источник

НН

Нац Нац in DocOps-сообщество
Fox Mulder
А вы поднимали такой сервис в рамках поставленной задачи или в свободное время, выходные?
Судя по названию статьи и что это в рабочем блоге - задача
источник

FM

Fox Mulder in DocOps-сообщество
Ну всяко может быть. Я когда был моложе, работал и по выходным и дома, ночью, по будням. Когда хотелось что-то сделать
источник

L

Lejbron in DocOps-сообщество
Stas Rychkov
Привет, спасибо. А как вы строите коллективную работу по обновлению такой базы знаний? Каждый участник создаёт PR с RST-файлами?
Пока что все сосредоточенно в одних руках, если требуется что то обновить или дополнить то это делаю я. Механизм с реквестами используется больше для проверки вносимых данных непосредственными исполнителями задач.
источник

L

Lejbron in DocOps-сообщество
Fox Mulder
А вы поднимали такой сервис в рамках поставленной задачи или в свободное время, выходные?
Изначально начал изучать вопрос в свободное время, но когда понял важность вопроса и объяснил руководителю задача бала поставлена)
источник

L

Lejbron in DocOps-сообщество
Нац Нац
чем рисовали диаграмки? =3
Рисовал дизайнер, изначально делал в MIRO
источник

L

Lejbron in DocOps-сообщество
Сейчас уточню софт
источник

FM

Fox Mulder in DocOps-сообщество
Lejbron
Изначально начал изучать вопрос в свободное время, но когда понял важность вопроса и объяснил руководителю задача бала поставлена)
Сколько занало времени на ввод системы в рабочее состояние. Привлекались ли силы разработчиков?
источник

SR

Stas Rychkov in DocOps-сообщество
Lejbron
Пока что все сосредоточенно в одних руках, если требуется что то обновить или дополнить то это делаю я. Механизм с реквестами используется больше для проверки вносимых данных непосредственными исполнителями задач.
А что делаете с контрибуцией? Пользователи сами пишут материалы в RST, или вы конвертируете присланное в других форматах? Спасибо.
источник

L

Lejbron in DocOps-сообщество
Fox Mulder
Сколько занало времени на ввод системы в рабочее состояние. Привлекались ли силы разработчиков?
Нет, справился своими силами - Jenkins достаточно простая штука, все необходимые операции содержатся в Jenkinsfile, конфигурация самого Jenkins вся делается через GUI с встроенными подсказками
источник

L

Lejbron in DocOps-сообщество
Stas Rychkov
А что делаете с контрибуцией? Пользователи сами пишут материалы в RST, или вы конвертируете присланное в других форматах? Спасибо.
Информация может поступать из разных источников, вплоть до чата в slack. Структурируется и переносится в rst уже мной, ручками
источник

SR

Stas Rychkov in DocOps-сообщество
Lejbron
Информация может поступать из разных источников, вплоть до чата в slack. Структурируется и переносится в rst уже мной, ручками
Ага, ясно, спасибо.
источник

L

Lejbron in DocOps-сообщество
Нац Нац
чем рисовали диаграмки? =3
Рисовали в adode illustrator ((
источник

НН

Нац Нац in DocOps-сообщество
Понял-понял. Внедряйте uml или mermaid терь :3 дизигнер будет рад
источник