😈 Как продать команде новые процессы, чтобы они не сопротивлялись


Попытки улучшить процессы обычно заканчивается одинаково:
Зачем нам это?
Раньше было проще
и моё любимое

Очередная бюрократия, только мешает!

В итоге новые процессы либо игнорируют, либо выполняют формально, лишь бы отстали.


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


✅ Решать реальную боль, а не улучшать ради улучшения

— Нельзя просто сказать: «Теперь мы пишем документацию перед задачей».
— Нужно показать: «У нас нет доки для разработки и мы тратим первую часть спринта на уточнение требований. Давайте сначала требования, потом разработка?».


✅ Показывать быстрые победы

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

Новая форма баг-репорта? Первый же баг ушёл в работу без уточнений!
Автоматизация в Jira? Первая задача закрылась без ручного пинга!


✅ Встраивать в привычный ритм работы

Если процесс требует заполнять новую таблицу — забудьте, никто не будет этого делать.
Но если он встроен в инструмент, которым все пользуются — его скорее всего примут без боли.


Люди не против хороших процессов. Они против ненужных усложнений.

#этобаза

Очень рада за Майки и Анору — безумно понравился фильм даже после просмотра на русском.

Но я думала, что Оскар уйдёт Деми Мур.

И считаю, что победа Майки в одной номинации с Деми — буквально сюжет Субстанции 🫠

😱 FAQ не работают — что делать?
не делать факи

Логика появления чавошных понятная: люди задают одни и те же вопросы — давайте соберём их в FAQ.

Но на практике:
— FAQ есть, но в него никто не заглядывает
— ответ там есть, но люди всё равно спрашивают
— часть информации устарела, но её никто не обновляет


Почему так?

📌 FAQ — это ещё одно место, куда надо идти. Если человек уже пишет в чат, значит, путь до чата был проще и очевиднее, чем до фака*.
📌 Ответы требуют дополнительных действий. Прочитать, осмыслить, применить — проще спросить и получить готовое решение.


Что работает лучше?

✅ Встраивать знания в работу
Автоответы в мессенджере — бот сам кидает нужную ссылку
Подсказки в интерфейсе — решение сразу в контексте задачи
Ссылки в таск-трекере — почти как подсказки в интерфейсе, но для узкого кейса

✅ Давать результат, а не текст
Вместо инструкции «Как оформить доступ» — кнопка «Запросить доступ». И дальше уже подсказки по флоу, если они нужны.
Вместо «Как назвать задачу» — автогенерация заголовка (это ещё немножко магия)

✅ Не делать FAQ ради галочки
Если им не пользуются, его не должно быть. Если дублирует документацию, нужно улучшать поиск, а не плодить ещё один архив.

📌 Пользователи всегда выбирают самый быстрый способ получить ответ. Если FAQ не помогает, значит, нужен другой формат.

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

#этобаза

На Хабре вышла статья как мы в Ozon стайлгайд собирали

Читать и лайкать 💙

Если у вас недостаток мотивации, держите этих двух гениев

🕺 Танец милкшейка

🕺 Педро и его airpods

now work it🎵

Напоминание перед завтрашней конфой


1. Заранее подумайте о вопросах, которые хотели задать спикерам. Не надо ходить на конфу просто послушать — для этого будут записи в х2. Список вопросов я обычно просила ещё на этапе согласования командировки, чтобы понять будет ли реальная польза от билета 😿


2. Выберите доклады, на которые точно не пойдёте. Как раз те, которые посмотрите в записи. Оцените, есть ли смысл отдельно подойти ко спикеру и познакомиться. Но если к докладу нет вопросов, просто интересненько — лучше скипайте и смотрите на х2.


3. Приготовьте ссылку на свои контакты: тгк, сайт, сетку. С людьми можно просто знакомиться. Просто подходить и говорить «Привет, я Катя, занимаюсь процессами документирования и поддержки». Даже если кроме обмена контактами ничего не произойдёт — прокачаете свой иммунитет к кринжу 🐈


4. После конференции — посмотрите на список вопросов и ответы на них. Подумайте, зачем они вам и какие шаги вы можете по ним сделать. Посмотрите доклады, которые хотели посмотреть в записи. Напишите пару постов в свой тгк с заметками с конфы 😎


#TWD2
Меня там снова не будет, делитесь фотками и впечатлениями 😽

🎨Кто выступит в секции «Техническая документация» на IT-конференции «Стачка» в Ульяновске?

→ Татьяна Тимофеева – аналитик в Ibs. Доклад: «Трудности перевода, или Как хорошо написать документацию ГОСТ»
→ Дарья Цыплакова – руководитель отдела технической документации в Nemo.Travel. Доклад: «Писать нельзя делегировать: как маленькая команда техписов живет в большом бизнесе»
→ Вера Крючкова – руководитель направления технической документации в РУСАЛ. Доклад: «Как оптимизировать систему документации в компании, если требуется и клиентов привлечь, и ГОСТам соответствовать»
→ Константин Нежберт – технический писатель в АО «Флант». Доклад: «Орфография в контейнере: CI/CD для проверки документации»

Тезисы докладов по ссылке: https://ul25.nastachku.ru/technical-documentation-ul25

Кому будет полезно: техническим писателям; специалистам из продуктовых команд: аналитикам, продактам, тестировщикам; сеньор-разработчикам.

💡Эксперт секции: Екатерина Ушакова – руководитель отдела технической документации и UX-редактуры в Ozon Tech. Лектор курса Technical Communication в Университете Иннополис.

Присоединяйтесь к «Стачке» 18-19 апреля (Ульяновск, УлГПУ). Билеты на сайте: nastachku.ru/buynow

📣 Одна горячая новость за другой

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

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

Если откликаетесь — напишите мне в лс @ushkatia свои фио, чтобы я вас могла найти среди остальных откликов

Раньше я работала с людьми, которые знали наизусть всего Мильчина. Сейчас — с теми, кто просто пишет, как умеет. Это нормально. Но иногда ужас как хочется сначала исправить текст, а уже потом вчитываться в суть 🫠

Если вы не техпис, но хотите, чтобы текст выглядел аккуратно — вот короткий чек-лист. Помогает навести порядок даже в тикетах и вики

#️⃣ How to write like a techwriter

🔴 Списки — единообразные и без пляшущего форматирования.

🔴 Скобки — по минимуму, чаще всего их можно просто выкинуть.
Ильяхов: Без скобок

🔴 Сокращения — без точек: техплатформа, архревью.

🔴 Абзацы — через пустую строку, особенно если пишете в Notion или вики.

🔴 Заголовки —используем именно заголовки, не просто жирный текст; без точек, запятых и вопросительных знаков.

🔴 Тире — длинное, а не дефис.
На маке: ⇧ + ⌥ + тире. На винде: Alt + 0151 на цифровой клавиатуре.


Следующий glow up — вычищать канцелярит:
➡️ bureau.ru

Вы тоже техпис, даже если это не прописано в должности

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


А аккуратный текст — это не занудство, а уважение к читателю.
А оправдывание занудства — это не душнилово 🦆

🤩 Как писать сокращения в рабочих текстах

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

В тикетах можно увидеть: «Унесли на скоринг после архревью, отбалансируем после гринлайта». Всё понятно, если в теме. Но если задуматься — птичий язык.

🤩 Когда сокращение — это ок:
- слово понятно без расшифровки,
- его часто используют в команде,
- текст внутрикомандный.

🤩 Когда стоит задуматься:
- слово может быть непонятно новичку или смежнику,
- сокращение звучит двусмысленно,
- текст читает не только ваша команда.


🤩 Если термин привычный для читателя — всё ок. Такие сокращения звучат естественно, если все на одной волне.

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

Но если пишете «релизка» в документации для партнёров — лучше заменить на «описание релиза».

Хороший принцип: упрощайте для своих, но не шифруйте текст для остальных. Подумайте о тех, кто будет вашим текстом пользоваться

Зачем вообще стандарты, если ты не ГОСТ?

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

Тут заголовки жирным, там курсивом.
Здесь список с точками, там — с дефисами.
Кто-то пишет «результат будет получен», кто-то — «юзер увидит кнопку».

И вроде всё работает. Но:
- новичку тяжело вникать;
- читателю — тяжело читать;
- тебе — больно поддерживать.

Ой, Катя, докапываешься до букв. Я на это даже внимания не обращаю.
Обратишь, когда увидишь хороший текст 🙈

Стандарты — это не про ГОСТ
Это когда вы договорились писать тексты вдумчиво, заботиться о читателе, нести через текст пользу, а не поток сознания.

Это не душно. Это удобно.
Хотя всё-таки чууууть-чууть душновато, признаю 😅
И даже если у вас нет редактора — стандарты можно собрать из ваших же лучших примеров.

Подготовила вам серию постов, будем разбираться в минимальной гигиене ⭐️

Стачку отработали, всем спасибо! Было, как обычно, классно 😳

С Антоном работали в Ozon Tech, с Машей познакомились на прошлой Стачке и она вообще топ-звёздный спикер ⭐️

Ииии мы втроём кое-что для вас готовим 😐
Маша даже уже начинает потихоньку анонсировать, что именно