DocOps

Столкновение мнений в двух докладах на #RITfest2019.

Представьте, что есть некая IT-компания. Эта компания хочет нанимать новых людей и оставаться привлекательной для уже работающих. На этом факты кончаются и начинаются предположения.

Предположительно, для найма сотрудников полезна репутация компании. Её можно заработать, например, если писать что-то полезное в техноблоги, на Хабр, Реддит и куда угодно ещё. Чтобы писать интересно и не ерунду, писать должны сами разработчики. Внезапно, разработчики не любят писать, они любят кодить. А ещё у пиарщика есть KPI на статьи, но нет власти, чтобы поставить разработчику дедлайн.

Как сделать так, чтобы разработчики писали статьи в блог компании?

Мария Круглова из KODE предлагает редактору сделать за разработчика всё, что только можно. Сформулировать тему, сделать из черновика или доклада готовый текст и вручить его разработчику. Вот её собственное определение роли:

Ghostwriter — человек, влияющий на создание статьи с момента зарождения идеи, в течение всего процесса её написания и защиты, активный модератор статьи, корректор и психолог. Его задача — сформировать у разработчика уверенность, что он сам написал статью.

Антонина Татчук из Авито, напротив, рекомендует помогать и поддерживать автора, но не писать за него. А если разработчик обещал, но не выходит на связь и не пишет — не писать за него и не начинать с ним новых статей, пока не принесёт хотя бы черновик.

Конспекты:
— Профессия «Ghostwriter», или Учим программистов писать статьи, Мария Круглова, KODE.
— Пишем не только код, но и статьи: как помочь разработчику стать техноавтором, Антонина Татчук, Авито.

​​Продвижение опенсорс-проектов

Андрей Ситник из Злых Марсиан рассказывает на #RITfest2019 о продвижении опенсорс-проектов. Рассказывает очень чётко и по делу, я как технический писатель со многим согласен. Особенно понравилась инструкция, как написать три первых абзаца README.

Вот конспект: https://github.com/docops-hq/conf/blob/master/frontendconf/19/promoting-opensource.md

Сегодня и завтра идёт фестиваль «Российские интернет-технологии», #RITfest2019.

Как обычно, я постараюсь законспектировать десяток интересных докладов. Всё выложу на гитхаб: https://github.com/docops-hq/conf.
Если вы тоже на конференции и что-то записываете — присылайте пуллреквесты.

Если вы не на конференции — посмотрите открытую трансляцию из главного зала. Там собраны одни из самых популярных и важных докладов.

Прямо сейчас идёт
Гипербатон от Яндекса.

В программе девять докладов про документацию и локализацию в IT.

Трансляция: https://events.yandex.ru/events/hyperbaton/25-may-2019/

Техписатели из Xsolla опубликовали третью часть эпоса про непрерывную локализацию.

https://habr.com/ru/post/452580/

​​Люблю опенсорс за дружелюбие и удобство.

​​— Почему пользователи StackOverflow начинают вопросы со слова Say? Например:

Say “How to get data array for a numpy array with python"

— А потому что в документации такой пример.

За ссылку спасибо @factorized.

​​В документации Grav CMS уже прочитанные главы помечаются галочкой.

❤️

Привет! Поделитесь опытом, пожалуйста, как описывать все БД, если у тебя есть только IDE. С чего нужно начать, какие инструменты лучше использовать?

Я не знаю, как документировать БД. Если вы знаете, пожалуйста, расскажите об этом в @docsascode.

Как я 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

How to Create Compelling Multimedia Documentation.

Alexandra White из Google рассказывает, как сделать документацию в форме видео и вебинаров. А ещё — когда её делать не нужно.
Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/multimedia-documentation.md

#knowledgeconf2019

Добро пожаловать на борт: вводим в строй новых разработчиков

Глеб Декайло рассказал на #knowledgeconf2019 про то, как в Badoo вводят в команду новых сотрудников.

За конспект спасибо Екатерине Носковой! https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/badoo-new-developers-onboarding.md

Применение практик Тиаго Форте для управления своими знаниями.

Огненный доклад на #knowledgeconf2019 от Андрея Александрова про то, как читать книги и статьи like a boss и наполнять собственную базу знаний.

Конспект: https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/tiago-forte-practices.md

10 компетенций и 6 ролей Knowledge Manager

Сегодня на #knowledgeconf2019 модерирую зал Кембридж и пишу конспекты. Потому что могу!

Первый доклад — от Марии Мариничевой, о том как найти и обучить собственного менеджера знаний.

https://github.com/docops-hq/conf/blob/master/knowledgeconf/19/knowledge-manger-6-10.md

Читатели, как вы знаете, чуть менее, чем через неделю состоится KnowledgeConf - первая профессиональная конференция по управлению знаниями в IT компаниях. На ней собрали интересные кейсы, дискуссии и спикеров из таких компаний, как Badoo, Skyeng, Google, КРОК, Lamoda, Миран, Skillbox, Стратоплан, Тинькофф, БИОКАД, Ozon и еще десятка уважаемых компаний.

У вас есть отличная возможность буквально на флажке выиграть билет на нашу конференцию и другие подарки 🔥🔥🔥.

1. До 23:59 по Москве 23 апреля разместите пост в любимой соцсети или канале в Телеграмме о том, какую практику в управлении знаниями вам удалось применить или чем, как вам кажется, вашей компании было бы полезно управление знаниями (тема на выбор).
2. Добавляете хэштег #knowledgeconf2019 ВАЖНО! Ваш профиль должен быть открыт на время проведения флешмоба, чтобы мы могли найти ваш пост по хэштегу.
3. 23 апреля в 23:59 мы случайным образом разыграем билет на конференцию и утешительные призы - три любимые книги, рекомендованные членами Программного комитета конференции. Книги мы передадим лично или отправим почтой в любой город.
4. Каждый участник конкурса получит скидку на билет в размере 10 процентов.

Участвуйте! Конференция обещает быть очень крутой. Кстати, подписанным на этот канал быть не обязательно, так что репостите информацию.

Мы обещали вам подробно рассказать о том, что еще будет на KnowledgeConf кроме докладов, и держим слово. А будет интересное — будем экспериментировать и мечтать. И обязательно посмотрите на идеи из непринятых докладов и напишите в комментариях, что нужно обсудить в будущем.
https://habr.com/ru/company/oleg-bunin/blog/445040/

Смотрите, в какое плотное расписание мы упаковали все доклады KnowledgeConf. Три потока по восемь докладов и один трек под специальные форматы – имеет смысл наметить маршрут по конференции заранее.
https://knowledgeconf.ru/2019/schedule.html

27 отборных докладов и мастер-классов про управление знаниями в IT.