10 компетенций и 6 ролей Knowledge Manager
Сегодня на #knowledgeconf2019 модерирую зал Кембридж и пишу конспекты. Потому что могу!
Первый доклад — от Марии Мариничевой, о том как найти и обучить собственного менеджера знаний.
https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/knowledge-manger-6-10.md
Сегодня на #knowledgeconf2019 модерирую зал Кембридж и пишу конспекты. Потому что могу!
Первый доклад — от Марии Мариничевой, о том как найти и обучить собственного менеджера знаний.
https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/knowledge-manger-6-10.md
Применение практик Тиаго Форте для управления своими знаниями.
Огненный доклад на #knowledgeconf2019 от Андрея Александрова про то, как читать книги и статьи like a boss и наполнять собственную базу знаний.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/tiago-forte-practices.md
Огненный доклад на #knowledgeconf2019 от Андрея Александрова про то, как читать книги и статьи like a boss и наполнять собственную базу знаний.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/tiago-forte-practices.md
Добро пожаловать на борт: вводим в строй новых разработчиков
Глеб Декайло рассказал на #knowledgeconf2019 про то, как в Badoo вводят в команду новых сотрудников.
За конспект спасибо Екатерине Носковой! https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/badoo-new-developers-onboarding.md
Глеб Декайло рассказал на #knowledgeconf2019 про то, как в Badoo вводят в команду новых сотрудников.
За конспект спасибо Екатерине Носковой! https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/badoo-new-developers-onboarding.md
How to Create Compelling Multimedia Documentation.
Alexandra White из Google рассказывает, как сделать документацию в форме видео и вебинаров. А ещё — когда её делать не нужно.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/multimedia-documentation.md
#knowledgeconf2019
Alexandra White из Google рассказывает, как сделать документацию в форме видео и вебинаров. А ещё — когда её делать не нужно.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/multimedia-documentation.md
#knowledgeconf2019
Как я 15 лет делал себе персональную Wiki для программиста
Григорий Петров придумал себе язык разметки для собственной вики-системы и пишет в нём заметки 15 лет. Я смотрел только предварительный прогон ещё в январе, и мне больше всего запомнилось вот что:
1. Я два года не писал на Ruby и ничего не помню
2. За два часа я перечитываю свой конспект по Ruby
3. Теперь я снова middle-разработчик на Ruby. PROFIT!
Спасибо Андрею Александрову (@aladmit_world) за конспект. https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/xi-notes-for-developer.md
---
Trello — эффективная система управления знаниями для небольшой IT-команды
Не думали, что так можно? Вот и я удивлён. Роман Хорин рассказывает, как Trello работает в качестве базы знаний для команды дизайнеров в Atman Digital. Особенно хорошо такая база знаний помогает вводить новичков в команду.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/trello-kb.md
#knowledgeconf2019
Григорий Петров придумал себе язык разметки для собственной вики-системы и пишет в нём заметки 15 лет. Я смотрел только предварительный прогон ещё в январе, и мне больше всего запомнилось вот что:
1. Я два года не писал на Ruby и ничего не помню
2. За два часа я перечитываю свой конспект по Ruby
3. Теперь я снова middle-разработчик на Ruby. PROFIT!
Спасибо Андрею Александрову (@aladmit_world) за конспект. https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/xi-notes-for-developer.md
---
Trello — эффективная система управления знаниями для небольшой IT-команды
Не думали, что так можно? Вот и я удивлён. Роман Хорин рассказывает, как Trello работает в качестве базы знаний для команды дизайнеров в Atman Digital. Особенно хорошо такая база знаний помогает вводить новичков в команду.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/trello-kb.md
#knowledgeconf2019
Я не знаю, как документировать БД. Если вы знаете, пожалуйста, расскажите об этом в @docsascode.
Forwarded from Elena Baskakova
Привет! Поделитесь опытом, пожалуйста, как описывать все БД, если у тебя есть только IDE. С чего нужно начать, какие инструменты лучше использовать?
DocOps
Непрерывная локализация. Слышали про принцип «сдвига влево» (shift left)? Непрерывная локализация (continuous localization) реализует этот принцип для перевода документации, интерфейса и других текстов. Раньше было так: сначала разработка, потом пишем тексты…
Техписатели из Xsolla опубликовали третью часть эпоса про непрерывную локализацию.
https://habr.com/ru/post/452580/
https://habr.com/ru/post/452580/
Хабр
20 проектов, 20 языков, срок вчера. Часть 3
Заключительная статья об интеграции Serge+Smartcat. В этой статье я расскажу, как мы масштабируем Serge на всю компанию, рассмотрю 4 нестандартных интеграции и,...
Прямо сейчас идёт
Гипербатон от Яндекса.
В программе девять докладов про документацию и локализацию в IT.
Трансляция: https://events.yandex.ru/events/hyperbaton/25-may-2019/
Гипербатон от Яндекса.
В программе девять докладов про документацию и локализацию в IT.
Трансляция: https://events.yandex.ru/events/hyperbaton/25-may-2019/
Сегодня и завтра идёт фестиваль «Российские интернет-технологии», #RITfest2019.
Как обычно, я постараюсь законспектировать десяток интересных докладов. Всё выложу на гитхаб: https://github.com/docops-hq/conf.
Если вы тоже на конференции и что-то записываете — присылайте пуллреквесты.
Если вы не на конференции — посмотрите открытую трансляцию из главного зала. Там собраны одни из самых популярных и важных докладов.
Как обычно, я постараюсь законспектировать десяток интересных докладов. Всё выложу на гитхаб: https://github.com/docops-hq/conf.
Если вы тоже на конференции и что-то записываете — присылайте пуллреквесты.
Если вы не на конференции — посмотрите открытую трансляцию из главного зала. Там собраны одни из самых популярных и важных докладов.
Продвижение опенсорс-проектов
Андрей Ситник из Злых Марсиан рассказывает на #RITfest2019 о продвижении опенсорс-проектов. Рассказывает очень чётко и по делу, я как технический писатель со многим согласен. Особенно понравилась инструкция, как написать три первых абзаца README.
Вот конспект: https://github.com/docops-hq/conf/blob/master/frontendconf/19/promoting-opensource.md
Андрей Ситник из Злых Марсиан рассказывает на #RITfest2019 о продвижении опенсорс-проектов. Рассказывает очень чётко и по делу, я как технический писатель со многим согласен. Особенно понравилась инструкция, как написать три первых абзаца README.
Вот конспект: https://github.com/docops-hq/conf/blob/master/frontendconf/19/promoting-opensource.md
Столкновение мнений в двух докладах на #RITfest2019.
Представьте, что есть некая IT-компания. Эта компания хочет нанимать новых людей и оставаться привлекательной для уже работающих. На этом факты кончаются и начинаются предположения.
Предположительно, для найма сотрудников полезна репутация компании. Её можно заработать, например, если писать что-то полезное в техноблоги, на Хабр, Реддит и куда угодно ещё. Чтобы писать интересно и не ерунду, писать должны сами разработчики. Внезапно, разработчики не любят писать, они любят кодить. А ещё у пиарщика есть KPI на статьи, но нет власти, чтобы поставить разработчику дедлайн.
Как сделать так, чтобы разработчики писали статьи в блог компании?
Мария Круглова из KODE предлагает редактору сделать за разработчика всё, что только можно. Сформулировать тему, сделать из черновика или доклада готовый текст и вручить его разработчику. Вот её собственное определение роли:
Ghostwriter — человек, влияющий на создание статьи с момента зарождения идеи, в течение всего процесса её написания и защиты, активный модератор статьи, корректор и психолог. Его задача — сформировать у разработчика уверенность, что он сам написал статью.
Антонина Татчук из Авито, напротив, рекомендует помогать и поддерживать автора, но не писать за него. А если разработчик обещал, но не выходит на связь и не пишет — не писать за него и не начинать с ним новых статей, пока не принесёт хотя бы черновик.
Конспекты:
— Профессия «Ghostwriter», или Учим программистов писать статьи, Мария Круглова, KODE.
— Пишем не только код, но и статьи: как помочь разработчику стать техноавтором, Антонина Татчук, Авито.
Представьте, что есть некая IT-компания. Эта компания хочет нанимать новых людей и оставаться привлекательной для уже работающих. На этом факты кончаются и начинаются предположения.
Предположительно, для найма сотрудников полезна репутация компании. Её можно заработать, например, если писать что-то полезное в техноблоги, на Хабр, Реддит и куда угодно ещё. Чтобы писать интересно и не ерунду, писать должны сами разработчики. Внезапно, разработчики не любят писать, они любят кодить. А ещё у пиарщика есть KPI на статьи, но нет власти, чтобы поставить разработчику дедлайн.
Как сделать так, чтобы разработчики писали статьи в блог компании?
Мария Круглова из KODE предлагает редактору сделать за разработчика всё, что только можно. Сформулировать тему, сделать из черновика или доклада готовый текст и вручить его разработчику. Вот её собственное определение роли:
Ghostwriter — человек, влияющий на создание статьи с момента зарождения идеи, в течение всего процесса её написания и защиты, активный модератор статьи, корректор и психолог. Его задача — сформировать у разработчика уверенность, что он сам написал статью.
Антонина Татчук из Авито, напротив, рекомендует помогать и поддерживать автора, но не писать за него. А если разработчик обещал, но не выходит на связь и не пишет — не писать за него и не начинать с ним новых статей, пока не принесёт хотя бы черновик.
Конспекты:
— Профессия «Ghostwriter», или Учим программистов писать статьи, Мария Круглова, KODE.
— Пишем не только код, но и статьи: как помочь разработчику стать техноавтором, Антонина Татчук, Авито.
Как наполнить статьями техноблог компании?
Anonymous Poll
7%
Одинокий воин: освоить предметную область, писать статьи самостоятельно.
17%
Ghostwriter: писать статьи из черновиков разработчиков, публиковать под их именем.
70%
Фасилитатор: поддерживать тех, кто хочет писать статьи. Помогать редактурой, дизайном и пиаром.
6%
Начальник: поставить разработчикам KPI, пусть пишут по статье в квартал.
Blameless environment: никто не должен писать качественный код
Продолжаем #RITfest2019. Кто хоть раз работал на плохой работе? Там где код плохой, и процессы плохие, и клиенты плохие, и вообще всё плохо? Кто был виноват в том, что всё так плохо?
Никита Соболев из wemake.services считает, что никто не виноват, а искать виноватых вообще вредно. Гораздо лучше исправлять ошибки на системном уровне и развиваться. Конечно, об этом просто говорить и сложно сделать. Никита, по его словам, выстроил в своей компании систему, в которой никто не виноват. В докладе он последовательно рассказывает о принципах, на которых строится такая система.
Если вы ещё не слушали ни одного доклада Никиты и не знаете про внутреннюю кухню wemake.services, я особенно рекомендую вам прочитать конспект или послушать доклад. Либо вам это очень понравится, либо вы будете дико возмущены.
Конспект: https://github.com/docops-hq/conf/blob/master/qualityconf/19/blameless.md
Сегодня доклад ещё можно посмотреть в трансляции, но скоро ссылка перестанет работать: https://youtu.be/V95bBGB-89Y?t=8561
Продолжаем #RITfest2019. Кто хоть раз работал на плохой работе? Там где код плохой, и процессы плохие, и клиенты плохие, и вообще всё плохо? Кто был виноват в том, что всё так плохо?
Никита Соболев из wemake.services считает, что никто не виноват, а искать виноватых вообще вредно. Гораздо лучше исправлять ошибки на системном уровне и развиваться. Конечно, об этом просто говорить и сложно сделать. Никита, по его словам, выстроил в своей компании систему, в которой никто не виноват. В докладе он последовательно рассказывает о принципах, на которых строится такая система.
Если вы ещё не слушали ни одного доклада Никиты и не знаете про внутреннюю кухню wemake.services, я особенно рекомендую вам прочитать конспект или послушать доклад. Либо вам это очень понравится, либо вы будете дико возмущены.
Конспект: https://github.com/docops-hq/conf/blob/master/qualityconf/19/blameless.md
Сегодня доклад ещё можно посмотреть в трансляции, но скоро ссылка перестанет работать: https://youtu.be/V95bBGB-89Y?t=8561
Фестиваль РИТ продолжается, есть открытая трансляция второго дня: https://www.youtube.com/watch?v=a5kq-Yk28po
YouTube
28 мая, "Конгресс-Холл" (Главный зал), РИТ++ 2019
Самые лучшие доклады всех семи конференций фестиваля в открытом доступе, день второй:
11:00 — Как доставить быстро и без боли. Автоматизируем релизы / Александр Коротков (ЦИАН)
12:00 — Аварии помогают учиться / Алексей Кирпичников (Контур)
13:00 — Метрики…
11:00 — Как доставить быстро и без боли. Автоматизируем релизы / Александр Коротков (ЦИАН)
12:00 — Аварии помогают учиться / Алексей Кирпичников (Контур)
13:00 — Метрики…
Forwarded from Пятничный деплой
Большой молодец @Nick_Volynkin сделал конспект доклада Flant о werf с РИТ++ https://github.com/docops-hq/conf/blob/master/devopsconf/19/werf.md #flant
werf — наш инструмент для CI/CD в Kubernetes
Всё-таки напишу про werf и доклад о нём. Хочу сказать кое-что очень важное.
Docker и kubernetes сильно облегчают поставку приложений. Но у них есть свои особенности и ограничения. Либо мы используем специальные практики и инструменты, либо на серьёзных проектах всё получается довольно плохо. Образы распухают в размерах, registry засоряется, сборки образов длятся вечность, а k8s ошибается при накатывании новой конфигурации и сам не откатывается назад.
Я вот только начал сталкиваться с этими проблемами в нашем тулчейне для документации, а ребята из Фланта уже пять лет их решают и неплохо продвинулись. Доклад Дмитрия Столярова на #RITfest2019 — о проблемах с Docker и k8s и о том, как эти проблемы решает werf, новый инструмент для CI/CD в k8s.
Это нечастый случай: наши ребята сделали инструмент, который может занять достойное место в экосистеме Docker. У него есть конкуренты, конечно же, но ни один пока не решил всех проблем. Конкурентная борьба продолжается.
Давайте им поможем. Вот прямо сейчас зайдите и поставьте звёздочку: werf. И обязательно попробуйте werf в деле.
Конспект: https://github.com/docops-hq/conf/blob/master/devopsconf/19/werf.md.
На картинке ниже синим — что уже реализовано в werf, жёлтым — планируется к концу лета.
Всё-таки напишу про werf и доклад о нём. Хочу сказать кое-что очень важное.
Docker и kubernetes сильно облегчают поставку приложений. Но у них есть свои особенности и ограничения. Либо мы используем специальные практики и инструменты, либо на серьёзных проектах всё получается довольно плохо. Образы распухают в размерах, registry засоряется, сборки образов длятся вечность, а k8s ошибается при накатывании новой конфигурации и сам не откатывается назад.
Я вот только начал сталкиваться с этими проблемами в нашем тулчейне для документации, а ребята из Фланта уже пять лет их решают и неплохо продвинулись. Доклад Дмитрия Столярова на #RITfest2019 — о проблемах с Docker и k8s и о том, как эти проблемы решает werf, новый инструмент для CI/CD в k8s.
Это нечастый случай: наши ребята сделали инструмент, который может занять достойное место в экосистеме Docker. У него есть конкуренты, конечно же, но ни один пока не решил всех проблем. Конкурентная борьба продолжается.
Давайте им поможем. Вот прямо сейчас зайдите и поставьте звёздочку: werf. И обязательно попробуйте werf в деле.
Конспект: https://github.com/docops-hq/conf/blob/master/devopsconf/19/werf.md.
На картинке ниже синим — что уже реализовано в werf, жёлтым — планируется к концу лета.