Size: a a a

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

2021 January 22

СФ

Семён Факторович... in DocOps-сообщество
Maria Ermakovich
Management is watching as someone struggles at what you can easily accomplish или что-то такое )
Только первые год-два, потом привыкаешь:)
источник

ME

Maria Ermakovich in DocOps-сообщество
наверное это что-то типа вопроса "чуваки с детьми, какие преимущества у детей?")
источник

AN

Andrew Nilove 💔 in DocOps-сообщество
Maria Ermakovich
наверное это что-то типа вопроса "чуваки с детьми, какие преимущества у детей?")
Появляется смысл жить?
источник

ME

Maria Ermakovich in DocOps-сообщество
Andrew Nilove 💔
Появляется смысл жить?
у меня в этом месте кот )
источник

EN

Ekaterina Noskova in DocOps-сообщество
Maria Ermakovich
наверное это что-то типа вопроса "чуваки с детьми, какие преимущества у детей?")
скорее "подумываю завести детей, получается ли ходить на вечеринки?")
источник

AN

Andrew Nilove 💔 in DocOps-сообщество
Maria Ermakovich
у меня в этом месте кот )
если умрете одна в квартире, он, не задумываясь, будет есть вас. )
источник

СФ

Семён Факторович... in DocOps-сообщество
Я вот когда-то (11 лет назад, ужас) переходил из разработчиков в ПМы и задавался тем же вопросом — не буду ли я жалеть о том, что перестал кодить.

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

И двадцатью руками я теперь могу накодить куда больше, чем своими двумя.

С тех пор я так и хожу просветленный.
источник

ME

Maria Ermakovich in DocOps-сообщество
Семён Факторович
Я вот когда-то (11 лет назад, ужас) переходил из разработчиков в ПМы и задавался тем же вопросом — не буду ли я жалеть о том, что перестал кодить.

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

И двадцатью руками я теперь могу накодить куда больше, чем своими двумя.

С тех пор я так и хожу просветленный.
источник

ME

Maria Ermakovich in DocOps-сообщество
есть ещё одна картинка, неприличная
источник

СФ

Семён Факторович... in DocOps-сообщество
Maria Ermakovich
есть ещё одна картинка, неприличная
Ускоренная релокация, да
источник

EG

Elena Grahovac in DocOps-сообщество
А кто-нибудь знает, откуда эта картинка? 🙂 Может, там еще что-то полезное есть...
источник

NV

Nick Volynkin in DocOps-сообщество
Elena Grahovac
А кто-нибудь знает, откуда эта картинка? 🙂 Может, там еще что-то полезное есть...
Минутку...
источник

NV

Nick Volynkin in DocOps-сообщество
​​Пока кто-нибудь только задумывается о переезде с допотопных CMS на docs-as-code, продвинутые ребята из Lisk переезжают с Markdown на AsciiDoc и Antora.

Хоть я и перетащил на reST пару десятков проектов, для меня в этой статье много полезного. Например, Lisk вместе со сменой инструмента переработали структуру доки. Их топологию можно использовать как «таблицу Менделеева»: про каждый сегмент подумать, а что из нашей документации сюда ложится? Как люди это найдут, как будут читать? А если ничего нет, не стоит ли написать?
источник

NV

Nick Volynkin in DocOps-сообщество
Оказывается, топология документации, про которую я писал в прошлом посте, взята из статьи Daniele Procida What nobody tells you about documentation.

Есть и видео доклада по этой теме: https://www.youtube.com/watch?v=t4vKPhjcMZg
источник

NV

Nick Volynkin in DocOps-сообщество
Похоже, что придумали это Daniele Procida и Tim Graham вместе. Вот упоминание аж из 2015 года, документация Django: https://github.com/django/django/commit/df3d5b1d73699b323aac377dffab039dca26c1e4

Спасибо @Aburnashev за подсказку.
источник

NV

Nick Volynkin in DocOps-сообщество
@grahovac  вот побольше про эту схему
источник

EG

Elena Grahovac in DocOps-сообщество
Класс! Спасибо большое!
источник

AD

Alyona Devon in DocOps-сообщество
ID:0
С декабря прошлого года я руковожу командой технических писателей в tarantool.io. Это новый для меня продукт, новая роль и гора новых задач. Тематика канала теперь тоже расширится. В 2021 году ждите постов про:

— документацию как продукт;
— профессиональный рост писателя;
— руководство командой писателей;
— место и роль документации в технических коммуникациях, управлении знаниями и developer relations;
— и вакансии в @docops_jobs, наконец-то!

Документация как код, мероприятия и другие хорошие штуки тоже останутся. Надеюсь, что смогу уделять каналу больше времени, чем в сложном 2020-м.

Если вы хотите поработать со мной в команде, пишите в личку @nick_volynkin хоть сейчас. Добавьте резюме и примеры работ, лучше на английском.
Можно уточнить
1)при налаживании процессов в распределении задач по команде, какой подход выбираете/выбрали/вдохновлялись примером?

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

Или обычно в принципе все члены команды умеют, знают и делают одно и тоже, рандомно выбирается. Ну или смотрится «кто свободный»

2) Меняли что-то в процессах по коммуникации с другими отделами (к примеру создание шаблона на обращение к команде, информирование в определенное время, учащение присутствие на митингах и такое прочее)
источник

a

arvikon in DocOps-сообщество
Nick Volynkin
​​Пока кто-нибудь только задумывается о переезде с допотопных CMS на docs-as-code, продвинутые ребята из Lisk переезжают с Markdown на AsciiDoc и Antora.

Хоть я и перетащил на reST пару десятков проектов, для меня в этой статье много полезного. Например, Lisk вместе со сменой инструмента переработали структуру доки. Их топологию можно использовать как «таблицу Менделеева»: про каждый сегмент подумать, а что из нашей документации сюда ложится? Как люди это найдут, как будут читать? А если ничего нет, не стоит ли написать?
Вот про топологии, и вообще про построение информации время от времени возвращаюсь к книге - https://www.amazon.com/Information-Architecture-Beyond-Louis-Rosenfeld-ebook/dp/B015D78JV6
источник
2021 January 23

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Семён Факторович
Я вот когда-то (11 лет назад, ужас) переходил из разработчиков в ПМы и задавался тем же вопросом — не буду ли я жалеть о том, что перестал кодить.

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

И двадцатью руками я теперь могу накодить куда больше, чем своими двумя.

С тех пор я так и хожу просветленный.
Брехня, из этих 20 рук 16.5 либо будут криворукие либо все равно сделают не так
источник