​​Вчера на конференции для аналитиков 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 заменит специалистов, но готовы к удивительным открытиям!

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

В дружественном канале @lovely_it_hell сегодня намечается отличный эксперимент — Игорь будет в режиме реального времени формулировать запросы в космос ChatGPT, чтобы они из неструктурированных данных создали стройную архитектуру. Присоединяйтесь сегодня в 19-30 по московскому времени!

Подоспели результаты опроса от DevCrowd

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

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

Интересно, что непосредственно сохранение и передача знаний ни в одном пункте не содержится, но уверена, тимлиды этим часто занимаются, например, в рамках развития команды и найма новичков.

👉 Посмотреть результаты

Наткнулась на канал, который в мемах (!) рассказывает о реальности применения гибких методологий. Сейчас репостну пару моих любимых мемов оттуда, переходите и подписывайтесь, чтобы посмотреть больше @agile_minutes

AI-based поиск по документации: уже стандарт?

Последнее время многие компании выкатывают свои эксперименты по прикручиванию AI/GPT к поиску по документации. Cтандартом это пока не стало, но как будто это не за горами.

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

Вот как минимум несколько примеров:
- Платежная платформа Stripe использует GPT-4, чтобы отвечать на запросы пользователей с помощью информации из их документации https://openai.com/customer-stories/stripe
- Следом платформа по извлечению, преобразованию, загрузке данных Airbyte выкатила свой подход к организации поиска по документации с помощью Relevance AI: можно попробовать на их сайте https://docs.airbyte.com/ или посмотреть короткую демонстрацию: https://www.loom.com/share/cef53d57e12a46e092c9fd653340bd65
- Дальше подключились разработчики инструментов — Motif объявили о запуске: http://markprompt.com GPT-4-based поисковая платформа, позволяющая тренировать модель на файлах в форматах MD, Markdoc и MDX, со встроенной аналитикой
- Затем GitBook представил альфа-версию Lens — AI дающего ответы на базе вашей документации https://docs.gitbook.com/product-tour/searching-your-content/lens Пока бесплатно на всех планах
- Наконец недавно анонсированные Copilot for Docs и DocsGPT, которые вообще перевернули правила игры и ищут по всей открытой документации к любым тулам, модулям и библиотекам и стараются найти ответ. По сути это альтернатива чтения документации и поиска ответов на StackOverflow, но без необходимости переключать контекст, например, выходить из IDE. Но умение задавать хорошие вопросы все еще нужно.

Вопрос открыт: станет ли это и когда таким же стандартом в инструментах для документации/баз знаний, как сейчас поиск или аналитика? И кто среагирует следующим?

Хотите упростить онбординг в команду — используйте сторителлинг

Наткнулась на интересную статью, в которой предлагается использовать элементы сторителлинга при онбординге инженера в команду. Вот несколько советов:

1. Расскажите немного об истории: дайте новичку контекст, расскажите как проект развивался, в чем была его миссия, почему вы принимали те или иные инженерные решения, например, выбирали стек. Объясните, в чем ценность вашей команды для компании.
2. Объясните архитектуру не с точки зрения кода, а с точки зрения пользовательского пути. Это поможет новичку выстроить цельную картину и заодно получше разобраться в бизнесе.
3. Визуализация помогает: нарисуйте простую схему взаимодействия компонентов, ее можно использовать в дальнейших сессиях и обновлять по ходу.
4. Не вдавайтесь в низкоуровневые детали реализации в первое время: новички итак первое время перегружены информацией, лучше рассказывать о проекте на более высоком уровне абстракции, затем вдавайсь в детали по отдельным задачам.

Читать тут: https://betterprogramming.pub/improve-onboarding-in-teams-through-the-magic-of-storytelling-31b7fc479483