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


👉 Слежу сама

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


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

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

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

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

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

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

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

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

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

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

#этобаза

Вежливо про сроки

Подслушала в офисе спор о том, как вежливо уточнить сроки.

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

〰️Просьба взять в работу до конца февраля〰️
мне спорно, потому что задачи должны быть процессами, а не просьбами.

〰️Когда сможете взять в работу? 〰️
кмк неплохо, но стоило это уточнить до формирования собственного видения сроков. Сейчас команда ответит, что в июле — что дальше будем делать?

〰️Крайний срок конец февраля — сможем уложиться?〰️
прошлый вариант плюс поинт, что срок уже крайний — что будем делать, если команда не сможет?.

Как вариант очень мягкого варианта:

Привет!
Этот проект нам нужен к концу февраля, *потому что*
Какой у вас механизм приоритезации? Что от нас надо, чтобы проект могли взять в ближайшее время?

Тут и аргументировали, и показали готовность помочь — всё по учебникам ненасильственных коммуникаций.


Но абсолютно нормальный вариант, которого не надо бояться:

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

Привет, я Катя 💼

Из техплатформы Яндекса

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


📁 Папка с каналами про тексты
▶️ Записи Techdoc Meetup


Могу долго и развёрнуто говорить про:

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


Консультирую, менторю — просто пишите @ushkatia

Ну что, как там? Не жалеешь?

Топ-вопрос прошлой недели 🌟

Жалеть — очень уж деструктивное занятие, его давайте сразу отбросим. Абсолютно ожидаемо и естественно, что пару раз я себя ловила на мысли «а не зря ли?..», но сразу от неё отказывалась. А то начнётся весь этот движ с подрывом доверия к самой себе, тревожностям и апатии. Будет что-то смущать — будем решать по ходу, сейчас всё хорошо.

Как там — часть посложнее 🥲

Интересно, необычно. Новые задачи, новый формат. Непривычно, что нет своей команды. Удивительно, что о некоторых вещах не задумывались и не выстраивали (хотя тогда на меня бы работы не осталось).

А вот люди — знакомые. Запрашивала доступы, а мне в ответ:

Катя, привет) готово
поздравляю с выходом =)

и нет ощущения какой-то совсем новой среды, очень много тепла за ту неделю случилось 💞


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

В среду посреди дня очень устала думать. Учитывая, что я обычно работаю из дома, смена обстановки, конечно, сильная, ещё и информации куча. Поэтому часа через 4 работы мозг просто начал отказывать. Подумала, что ну всё, остаток дня потерян.
Расстроилась.
Спустилась на этаж с джунглями, засела там на час, и удивилась как же полегчало 😱


Да, корпорации — спорная штука, но мне нравится ☀️

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

Вчера вот разбирали, зачем разным редакторам Figma. Не в том плане, что она не нужна, а разбирали что именно редактор делает в Figma.

Хорошо, что у меня уже была запланирована интеграция с Ильёй и можно просто сослаться на его курс 😎

Пока придумываю, чего б вам тут написать и разбираюсь с новой работой — придумала вот напомнить о Стачке в Ульяновске 18-19 апреля ✨

Провели черновые прогоны, готовим доклады и о ГОСТах (!)
впервые вы о них слышите от меня, кажется, но оставляли в формах обратной связи запросы

Других анонсов у меня пока нет 😄 готова выслушать ваши идеи 🙄

Почему внутреннюю документацию не читают
и как это исправить

📌 Главная проблема — документация существует отдельно от работы.

Люди не читают её не потому, что они плохие и ленивые, а потому что:
— проще спросить в чате, чем искать;
— инструкция не там, где её ожидают;
— текст перегружен, а ответа нет.

Как исправить?
нанять техписа

✅ Встраивать знания в процесс

В идеале документация должна появляться там, где принимается решение.
Но да, мало кто будет переделывать систему под доку.

Поэтому:
— добавляем шаблоны → коллеги сразу используют правильные форматы для задач и типовых описаний;
— встраиваем автоответы в мессенджерах → снижаем нагрузку на поддержку;
— делаем контекстные подсказки (ссылками тоже ок) → не надо бегать по десятку документов.

хотя к шаблонам у меня особая любовь, о ней — отдельно 😅

✅ Не плодить текст ради текста

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

Поэтому:
— вместо гигантского FAQ — бот или автоподбор ответов в чате;
— вместо стены текста — структурированная стена текста и примеры.

✅ Актуализировать, когда есть реальный запрос

Бывает, что обновление документации — это задача без дедлайна.
Когда-нибудь, кто-нибудь может быть и дойдёт...

Решение:
— ловим триггеры: появился повторяющийся вопрос → обновляем инфу;
— связываем с процессами: новый релиз → автоматическое ревью документации.


Но кто всё это будет делать?

🥺 вы, если вам не хочется вечно отвечать на одни и те же вопросы.
🎧 тимлиды, если видят, что команда тратит время на поиск инфы.
💐 продукты, если саппорт завален повторами.

Документация должна экономить время. Всё остальное — бесполезный архив.

#этобаза

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

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


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

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

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


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


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

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


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

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

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


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

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


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

#этобаза

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

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

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

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

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

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


Почему так?

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


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

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

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

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

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

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

#этобаза

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

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

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

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

🕺 Педро и его airpods

now work it🎵

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


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


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


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


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


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