Полезная статья от Рэнди Аю про проклятье знания, которому подвержены многие при написании туториалов, потому что сложно сделать верное предположение об уровне знаний пользователя.

Он приводит два примера, первый бытовой — про сервисы доставки ингредиентов для приготовления блюд, а второй про его собственный опыт написания туториалов по работе с R.

Пост

22 сентября платформа для совместной работы со знаниями Teamly проводит в Москве очное мероприятие, посвященное менеджменту знаний

Стоит сходить, чтобы послушать доклад Марии Мариничевой "Менеджмент знаний с чистого листа: как начать и что делать потом (опыт Оргкомитета Сочи 2014)", и узнать, как этот кейс выглядит с высоты прошедших лет.

Зарегистрироваться на мероприятие можно по ссылке.

​​Идеальный онбординг для разработчика

Доклад Антона Назарова на Saint Team Lead Conf про идеальный онбординг разработчика.

Он собрал 321 ответ в опросе про идеальный онбординг, как его видят разработчики + 78 человек рассказали о странных и плохих историях их онбординга.

Мыслей полезных там много, хорошо структурированы примеры "как не надо", но мне больше всего запомнилась особенно одна.

Когда разработчиков спрашивают, а что им собственно критично узнать в первые недели, то они первым делом упоминают то, что касается проекта, его архитектуры, нужные доступы, кто в команде, кто за что отвечает, зависимостей, как делаются вещи, например, как запускаются тесты или как создаются тестовые пользователи, а уже потом о целях компании, миссии, KPI, OKR, и прочем. В реальности порядок предоставления этой информации новичку часто обратный, сначала вся общая часть, а потом важная техническая в сокращенном формате. Вот эту пирамиду в идеале нужно перевернуть.

Ну а когда тебе это все рассказывает Геральд из Ривии, то как-то еще более убедительно получается))

​​Культура офбординга

Вера Маневич из Одноклассников рассказала о теме, которую я мечтала много лет затащить в рамках KnowledgeConf, о процессе офбординга, поставленном на рельсы.

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

Например, прямо в велкам-буке рассказывают, как выстроен процесс ухода, потому что “все уйдут, вопрос когда и как”.

Но даже в рамках команды можно завести офбординг-манифест, в котором оговорено, как люди уходят, как это коммуницируется команде и компании (часто люди узнают об уходе коллег постфактум, не надо так), как отбираются доступы и так далее.

—
Я бы сюда добавила, что важно прописать, как передаются критические знания, прям в виде чек-листа.

В IPONWEB у нас была практика handover встреч, когда один разработчик передает проект другому и есть прямо чек-лист, о чем надо рассказать и в каком порядке.

Yet another "новый способ работать с информацией"?

Недавно автор PARA Тиаго Форте упомянул в Твиттере новый инструмент для менеджмента персональных знаний — TANA и назвал его новым Roam.

Подписалась на early access, посмотрим, что за зверь.

​​Galactica AI — система, которая обучена на человеческих знаниях

Поигралась с Galactica AI, в нее можно задавать вопросы или давать конкретную задачу, например, сгенерируй статью про docs-as-code или переведи формулу на человеческий язык, она будет адаптировать корпус человеческих знаний в ответ.

Galactica обучена на корпусе текстов, включающем более 360 миллионов контекстных цитат и более 50 миллионов уникальных ссылок, нормализованных по разным источникам.

Я бы воспринимала ее как суперсематический поиск, который понимает еще и жанр, в котором нужно отдать ответ, но релевантность ответа уже надо оценивать "глазами".

Notion туда же

Да, я снова про AI. Вчера Notion, платформа для совместной работы с документами и задачами, анонсировал Notion AI. Это функция, которая позволяет генерировать части документов с помощью искусственного интеллекта, например, список пунктов или идеи на определенную тему, стартовый параграф, аутлайн документа, завершающий параграф или саммари. Пишете после / запрос и получаете готовый фрагмент текста, который потом можно переписать.

Функция находится в бета-тесте, пока будет бесплатной. Чтобы протестировать, нужно постоять в очереди. Я сейчас 12353-я.

Почитать описание
Посмотреть короткое демо

Спустя 22 года после создания, Evernote купили

Одно из старейших приложений для ведения заметок Evernote покупает компания Bending Spoons, малоизвестный разработчик приложений, например, в их активе есть приложение для обработки видео Splice.

Интересно, что CEO Evernote в своем блог-посте считает это большим шагом вперед.

Я Evernote пользовалась как основных заметочником и веб-клиппером лет 10-12 назад, потом после изменения политики лицензий перестала.

А еще я году в 2019 собеседовалась к ним и делала тестовое, чтобы в качестве технического автора писать локальный контент для России.

Интересно будет посмотреть, куда пойдет Evernote с новым владельцем.

​​Вчера на конференции для аналитиков Flow 2022 посмотрела доклад Натальи Буравовой из Контура Технический писатель-аналитик. Кто он такой и чем занимается в команде разработки

Зацепила одна мысль, потому что я и сама всегда так делала, работая техписателем в команде разработки: сначала нужно сформулировать проблему/боль пользователя, какая информация до него не доходит, затем понять, каким способом можно этот канал "починить" и не всегда способом будет именно написать документацию.

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

Наталья рассказала, что они формулируют гипотезы, как решить проблемы пользователя и выбирают наилучший вариант.

Немного науки на каникулах не помешает

В декабре выступала на конференции Write The Docs Australia. Несмотря на то, что доклад был про научные основы в техническом писательстве, думаю, что и в деле управления знаниями информация будет полезной — рассказываю на какие принципы в когнитивной науке, психологии, нейрофизиологии и лингвистике можно опираться, когда пишешь документацию.

Запись доклада на английском и сессии вопросов и ответов после публично доступна по ссылке.

Podlodka #302 – Онбординг

Все мы слышали истории плохого онбординга новичков в компанию: начиная c того, что в течение месяца сотруднику не выдавали ноутбук, заканчивая тем, что первые недели работы целиком состояли из буллшитных встреч про ценности и миссию. Вместе с Евгением Антоновым, опытным тимлидом и консультантом, мы разобрались с принципами хорошего онбординга и тем, как можно построить простой и качественный процесс в вашей собственной команде.

🎧 Слушать выпуск

​​Прочитала вчера эпичный тред в Твиттере о том, как сделать документацию в команде лучше.

Там много полезных советов, вроде сделать ее частью процесса, включить в определение сделанной задачи, поощрять и вознаграждать, устраивать документационные "хакатоны" или "read-only" пятницы.

Но мне больше всего запомнился вот такой совет:

"Постройте культуру "see something, say something".

Вообще-то это теглайн кампаний по обнаружению признаков терроризма или чрезвычайных ситуаций, но он подходит и здесь.

Увидел что-то странное или неочевидное в коде - скажи и зафиксируй. Долго разбирался в каком-то вопросе или участвовал в треде в Слаке на 100 сообщений — скажи и зафиксируй.

Ребята из DevCrowd проводят исследование руководителей разработки, тимлидов и СТО, думаю, среди моих подписчиков такие есть. Вот какие вопросы их интересуют:

- Какие навыки для руководителей самые важные
- По каким критериям оценивают их работу
- Сколько времени уходит на написание кода
- Как попадают в профессию, и куда из нее уходят
- Полезные для развития каналы, курсы и книги

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

👉 Пройти опрос

Что я планирую послушать на TeamLeadConf

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

Универсальных рецептов, как наладить эти процессы нет, но всегда стоит послушать профессионалов и обменяться опытом.

27 и 28 февраля 2023 в Москве пройдёт идеальная площадка для этого — мультиформатная конференция для тимлидов и руководителей TeamLead Conf 2023.

Я планирую и вам не могу не рекомендовать послушать вот эти доклады:

- Максим Цепков о профстандартах и моделях компетенций и почему невозможно сделать единую отраслевую рамку для всех.
- Адель Шадрина о наставничестве, как его внедрять и когда оно нужно.
- Владимир Малов о bus-факторе и как его считать. Или не считать.
- Рустам Агамалиев о том, как вести заметки, чтобы это было полезно всем и вам в первую очередь.
- Доклады из Яндекс-трека — это отдельная секция с топовыми спикерами, посвященная тому как в IT - компаниях устроены R&D - департаменты и как работать над инженерной культурой.

А еще мы с TeamLeadConf решили подарить одному из подписчиков канала онлайн-билет. 🎁

Условия простые: напишите в комментарии под этим постом любое сообщение, например, Хочу на конфу. А мы в ближайший понедельник в 18-00 по Москве рандомно выберем одного победителя, который сможет послушать все доклады онлайн, посмотреть виртуальные стенды партнеров и побыть в виртуальных кулуарах.

Вот прямо сейчас стартует митап от Лаборатории Касперского База знаний здорового техписа, присоединяйтесь, спикеры отличные: https://www.youtube.com/watch?v=uWU0oPimbDQ

Снова нейросети в помощь — наткнулась на сервис, Explain like I'm five, он умеет объяснять сложные концепты простым языком, как будто вам 5 лет.

Перед запросов можно выбрать уровень от Pretty Dumb до Pretty Smart и включить или выключить сарказм. Ответ про knowledge management вполне сносный.

Ссылка на сервис тут.

Никогда еще не публиковала тут вакансии, но не могу удержаться — это очень крутые задачи на стыке управления знаниями и техписательства

Вакансия Технического писателя для внутренней документации в команду Платформы Ozon, классный способ совмещать технические задачи, копание в коде, с коммуникацией с множеством SME. Если любите заниматься археологией и хочется прокачать техническую мышцу и много почерпнуть от классных разрабов —самое то. Когда-то я сама начинала именно как технический писатель для внутренней документации и это классная школа.

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

Апплаиться тут: https://job.ozon.ru/vacancy/tekhnicheskii-pisatel-platforma-instrumenti-avtomatizatsii-77993056/

Привет, друзья! В условиях временного перерыва у KnowledgeConf, важно, что энтузиасты все равно проводят классные мероприятия про управление знаниями.

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

Спикеры представят реальные кейсы из бизнеса и госкорпораций, а также расскажут, чем можно заменить западные сервисы Confluence и Notion.

Эксперты из Skillbox, «Объединенной авиастроительной корпорации», OZON, QSOFT, Московской школы управления СКОЛКОВО и других поделятся своим опытом и лучшими практиками в области управления знаниями.

Не упустите возможность узнать новое и полезное для вашей работы, даже если вы занимаетесь этим "подпольно", а не по основной должности 😉. Конференция пройдет офлайн, вживую, в Москве, 19 апреля. Сохраняйте дату в календаре.

Подробности и регистрация на сайте: teamly.ru/conf.

ChatGPT лишает работы архитекторов ПО

В четверг, в 19:30 мы в режиме реального времени проверим, насколько ChatGPT может справится с задачами архитектора программного обеспечения.
Мы будем пытаться создать структуру обмена данными, давая на вход криво сформулированные данные и добьёмся, чтобы chatgpt самостоятельно уточнил необходимое. Ну и поиграемся с разными формулировками, конечно.
Спойлер: мы не верим, что chatgpt заменит специалистов, но готовы к удивительным открытиям!

Ссылку для трансляции запощу в канал незадолго до.