Записи Techdoc Meetup

Пока готовим декабрьский анонс уже шестой встречи, напомню, что было в прошлых:

📹 Techdoc Meetup 0
структура документации, исследования, чат-боты

📹 Techdoc Meetup 1
опыт внедрения docs-as-code, работающая документация, принципы хорошего перевода

📹 Techdoc Meetup 2
атрибуты документации, создание стайлгайда и круглый стол о месте техписателя в процессе разработки

📹 Techdoc Meetup 3
дзен в работе техписателя, опыт создания художественных книг, проблемы docs-as-code

📹 Techdoc Meetup 4
техпис в продуктовой команде, зона ответсвенности техписа, использование ChatGPT

📹 Techdoc Meetup 5
режим аврала, автоматизация проверок по стайлгайду, совместная работа uxw, дизайнера и исследователя

✨ upd ✨
📹 Techdoc Meetup 6
документация как проект, ИИ в процессах, ребрендинг корпорации с точки зрения текстов

🤨 Techdoc Meetup 6

10 декабря, 19:00 офис Ozon Tech в Москве

Доклады об управлении текстовыми проектами, внедрении ИИ и росте UX-редакции

На круглом столе не просто говорим, а составляем профиль навыков техписателя

Зарегистрироваться 🎧

трансляция и запись тоже будут — при регистрации можно выбрать формат участия

А на этой неделе курс уже и заканчивается

Сегодня у нас ретро 🎧

Вообще группа маленькая — нас всего 5 студентов и заботливый куратор. Поэтому каждое занятие получается наболтаться вдоволь — и про сорванные дедлайны, и про воображаемые зарплаты. Сегодня вот повторяем всё: в парах разыгрываем ситуации, повторяем ключевую лексику.

Ну и материалы в Notion очень крутые — очень наглядно, очень удобно. Мне вообще кажется, что стоит пойти на этот курс только ради настолько структурированного пространства с лексикой 🤗

После курса остаётся ещё индивидуальная встреча с ментором, чтобы получить персональный фидбек и рекомендации 🤵

За 2024 год мало какая конференция обошлась без доклада о том, как ИИ всех заменит 🐶

Вот и я успеваю в тренды — выступаю на закрытом митапе с вопросом

Когда ИИ заменит техписателя?

Начну с интерактива

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


Источники

Статья о том, как сгенерированные респонденты с точностью 85% предсказывают ответы реальных пользователей

Исследование McKinsey о влиянии использования ИИ на выручку компаний

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

Большая статья-рассуждение о будущем ИИ. Тоже McKinsey, 2018 год

И проверить, насколько прогнозы сходятся с реальностью — в отчёте начала 2024 года


На десерт
Инструменты, которые я обычно использую для ИИ-задач

🌸 Claude — пишет человекоподобно, приятнее разговаривать, чем с ChatGPT

🌸 ChatGPT — всё ещё мощнейший инструмент для большинства задач. Но для текста предпочитаю Claude

🌸 Kandinsky — да, есть DALL-E, но по качеству генерации моё сердечко всё же с Kandinsky

❤️ Llama* — опенсорс моделька, которую можно под себя настроить, если уметь в разработку



На этом я в очередной раз убедилась, что делать мероприятия мне нравится больше, чем выступать на них

—
*принадлежит корпорации Meta, которая признана в РФ экстремистской

Проверяла домашки по курсу и заметила одну штуку, которую часто вижу и в наших тестовых

Слабые вычитки

Студенты проверяют работы друг друга, а кандидатов мы просим вычитать любую нашу статью.
И слишком часто вижу ответы «Ой да всё классно, текст понятный, ошибок нет, ставьте хороший балл»

❗️ В любом тексте, даже самом вылизанном и выверенном, можно найти места к улучшению.
❗️ Эти места можно найти не в опечатках или синонимах, но в анализе задачи, которую мы пытаемся решить текстом.

Поэтому я ожидаю не просто вычитку формата «посмотрел текст, вроде всё понял, ставьте максимальный балл», а разбор по всё тому же фреймворку APC/С (АЦВ/С).

Auditory Purpose Collaboration/Connection
Аудитория Цель Взаимодействие/Связь

1️⃣ Анализ целевой Аудитории

Судя по всему, эта статья для тех, кто ...
Тогда в неё можно добавить ... или Тогда информация о ... избыточна

2️⃣ Анализ Цели

После статьи читатель должен сделать/подумать/изменить свою жизнь так ...
Поэтому стоит добавить/убрать информацию о ...

3️⃣ Анализ Взаимодействия при подготовке документации

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

4️⃣ Анализ Связи готовой документации с окружающим читателя миром

Эту статью скорее всего будут читать при таких условиях ..., поэтому ...
Для понимания этой документации потребуется консультация эксперта в ...


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

Поэтому вычитки формата «я всё прочитал, вроде понятно» — это Слабые вычитки.

Будьте сильными — работайте не только с буквами, но и с причинами их возникновения ⭐️

Стартуем в 19:00

⚡️ Ссылка на трансляцию ⚡️

А если смотрите онлайн — присылайте ваши фото 🦫

Лучшее фото наградим сувениром 💖

✨ Просто хорошей вам пятницы и уютных выходных ✨

Завтра последняя в этом году профессиональная активность, а с понедельника будут анонсы уже на следующий год 🥰

Итак, анонсы 🤩

Лето
С партнёрами готовим целую конференцию для руководителей. Пока договариваемся с площадкой и готовим соцсети к большим анонсам.
Если вы руководитель и вас волнуют какие-то вопросики — делитесь ими, чтобы у нас была полная картина актуальных тем 🤩

Весна
Конечно же Стачка!
CFP уже открыт, у нас снова своя секция по документации — жду ваши спикерские заявки 🤩
Конференция 18-19 апреля в Ульяновске

Зима
вот эта, которая сейчас уже идёт
Есть вакансии ко мне 🤩
Ищем и UX-редактора, и техписателя — присылайте мне резюме, желательно сразу с портфолио. Позиции для младших специалистов, поэтому опыт не главное. В первую очередь ищем в команды b2b и внутренней документации, а там уже по вашим интересам и нашим потребностям 🤩


Это, конечно, не всё
В работе много активностей для сообщества техписателей, в том числе с другими компаниями, в том числе и не митапы 🤩

Например, меня можно приглашать консультировать вашу команду по процессам, инструментам и гайдам. За этот год уже провела несколько таких сессий — пишите, если вам тоже надо, обсудим детали 🤩

а вчера вернулась в Москву и меня очень порадовал пустой виджет перелётов 💃

Если вам было нечем отбиваться от «а давайте напишем, что наш сервис лучший, выгоднейший и вообще» — ФАС всё агрументировали за вас 🦖

https://fas.gov.ru/news/33701

Спрашивали меня недавно, как выглядит идеальный рабочий день

Отвечала, что точно знаю — без утреннего чтения день будет значительно хуже, чем хотя бы с десятком страниц.
А потом смотрю итоги года в Яндекс.Книгах и надеюсь, что просто много читала в бумаге 🗿🗿

32 книги против 38 прошлогодних

Стала думать — а как так получилось? Поняла, что в этом году больше читала статей, больше смотрела записей с конференций, больше уделяла подготовке своей книги в те самые 30-40 утренних минут перед созвонами.

А ещё заметила (в октябре), что была одна большая и не очень интересная книга — она-то меня и тормозила. А я и не сразу-то поняла. Бросила её и снова стало легко читаться.

В итоге всё стандартно:

- либо нужна мотивация доделывать что-то неприятное — ясная цель в конце пути
- либо надо кайфовать от самого пути — стройные и прозрачные процессы

можно совмещать

Если до 31-го не вернусь с постами — вот вам пожелание авансом:

кайфуйте в том, что делаете ☺️

С Новым 🎄
Пусть всё будет ❤️

Большой пост про карты навыков

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

Но технически не сложилось.
Тогда я подумала: «Ладно, просто потом в канал выложу, пусть будет» 😒

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


Почему я не люблю публичные матрицы компетенций

1️⃣: есть тенденция потом использовать их как бинго
Мол, гляди дорогой лид, я всё освоил!
И тогда надо вводить систему оценки качества освоения.
Дальше вопрос: «А зачем ты всё это освоил?».
Ответ, кстати, не так однозначен, как можно подумать. Но для очевидного есть большое «но»:

Работа — не университет, где платят стипендию за хорошие оценки
Поэтому на работе знания в отрыве от задач бизнеса не несут никакой ценности

2️⃣: есть привычка приходить в чужой монастырь со своей матрицей.
«Вот я по такой-то матрице всё выучил (снова бинго), берите меня в свою команду на позицию как у вас там главный называется?» 🔝
На митапе был этот момент: в Ozon надо знать git, md-разметку, хоть немного, но разбираться в процессах разработки. А вот для команды техписов в платформе «немного» уже не подойдёт. Хотя с другой стороны — есть компании с wysiwyg-редакторами и им вообще разметка не нужна (лайк, если надо рассказать, почему в Ozon я wysiwyg не внедряла).

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


Классно, Кать, объяснила, а что делать-то?

Искать ментора. Желательно из той компании, подход которой вам близок 😌
Не обязательно ждать, пока интересный вам человек явно анонсирует менторство (некоторые стесняются, думают, что у них пока мало опыта) — подходите на митапе, конференции, пишите в соцсетях.

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

Даже если вы не новичок — всё равно у других экспертов есть чему поучиться.

И общее пожелание от меня

Так будьте же открыты новому, исследуйте и достигайте ❤️

Если вы пошли из списка личных целей от Техписалити и загадывали в 2025 выступить на конференции — до 31 января подавайте заявки на Стачку 🌌

А если у вас пока что нет полного видения доклада, а только идея или только желание — пишите мне. Обсудим, подготовимся, выступим 😻

Про медиану Факторовича техписатели уже знают, теперь время опроса для ux-текстов 🐤

Источники актуальных знаний для техписов
на английском языке


👉 Слежу сама

https://www.thecontentwrangler.com/
https://technicalwriterhq.com/learn/
https://www.writethedocs.org/


👉 Знаю о существовании
но заглядываю очень редко

https://hackmamba.io/community/
https://writetechhub.org/ — у них даже есть bootcamp 💪
https://techwriters.dev/

Управление командой — это всегда игра в две стороны

Вот приходит заказчик и говорит, что им срочно, и вообще вчера, и надо прям щас всё бросить и делать 🐹

И количество таких заказчиков на единицу времени вообще не ограничено 🐹

Поэтому важно такие ситуации грамотно отрабатывать
(почему — можно отдельно поговорить)

Вот и приходится с одной стороны торговаться с заказчиком «а почему срочно?», «а у нас спринт с понедельника, а задача на половинку сторипоинта — успеваем в обычном порядке»

а с другой — сразу тасовать бэклог, чтобы посмотреть а куда метеорит-то упадёт 🐹

Нередко оказывается, что действительно до начала спринта (а то и до его конца) очень даже ждёт.
А то и на пару лет зависает на холде 🐹

Поэтому ваша менеджерская задача (даже если вы не менеджер) — вроде и не вестись на провокации заказчиков, а вроде и сразу продумывать запасные варианты 🐹

#этобаза