Ушакова — директор буковок
1.21K subscribers
268 photos
15 videos
252 links
Екатерина Ушакова
@ushkatia

Про мой опыт и форматы взаимодействия: ringova.com
Download Telegram
У нас в гайдах есть правило не говорить о датах. С завидной регулярностью разгораются споры с заказчиками на почве «ну что мы письма слать будем или фронтенд нагружать? давайте в доке напишем просто, что запускаем новый продукт 1 апреля». И честно — каждый раз руки опускаются. Потому что каждый раз заново объясняю про риски, про кредит доверия, про визуальный шум и про здравый смысл, в конце концов.

На скрине — супер уместно, но всё равно бесит.
💯974👍1
☀️ Напоминание о мотивации

Мотивация — ключ к продуктивности и удовлетворенности на работе.

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

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

Обеспечьте поддержку и ресурсы.
Поддержка в трудные моменты и доступ к нужным ресурсам могут сильно повысить мотивацию.

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

#mngr
❤‍🔥137💯42
В Иннополисе из-под снега робко виднеется асфальт, и разные комьюнити тоже выходят из спячки 🌸

◦ 6 марта — увидимся на митапе Kaspersky Tech Fest
◦ 12-13 апреля — готовлюсь выступать на Стачке в Ульяновске
◦ прогоны к Techdoc Meetup 4 уже переходят в чистовые стадии, скоро расскажем подробности
◦ на середину апреля договорились о записи подкаста 🌼

Ещё об одной штуке обговариваем детали и, надеюсь, скоро анонсируем 🦋

А в Инно завтра начинаем второй блок лекций — о типах целевых аудиторий, основных документах для них, метриках и исследованиях 🧁
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥22🎉10👏3
Ушакова — директор буковок
Ссылка на трансляцию
иииии мы в эфире, подключайтесь 🐈🐈
Please open Telegram to view this post
VIEW IN TELEGRAM
🛠 Конфликты: строим мосты, а не стены

Конфликты в команде неизбежны и их не надо бояться. Но надо учиться их адекватно решать.

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

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

#mngr
7👍5💯4
Весна — время обновлений не только в природе, но и в профессиональной сфере. Приведите в порядок техдоку: пересмотрите старые файлы, актуализируйте структуру, проверьте метрики.

Не знаю почему так, но почему бы и нет 😄

Чек-лист уборки

👍 Посмотрите на список существующих документов:
- какие совсем выкинуть;
- какие надо обновить;
- над какими надо основательно подумать.

👍 Соберите шаблоны, которые используете в работе:
- пользуются ли ими;
- надо ли что-то добавить;
- надо ли что-то убрать в архив.

👍 Обсудите в очередной раз в каком виде вы собираете и планируете собирать отзывы ваших читателей:
- надо ли прикрутить ФОС и если да, то кто его будет обрабатывать;
- какие исследования стоит запланировать, как их оценивать и кто их будет проводить;
- какие сезонные явления могут повлиять на метрики документации и как их оценивать.

👍 Поставьте в календаре дату следующей такой сверки

#techdoc
Please open Telegram to view this post
VIEW IN TELEGRAM
11🔥53👍2💯2
Загружаю видео с шикарным превью 😅

Ща будет вертикальное говорилово на три минуты ❤️
Please open Telegram to view this post
VIEW IN TELEGRAM
8😱5
Media is too big
VIEW IN TELEGRAM
Давно хотела поговорить на камеру, вот тема подвернулась про один-на-одины с руклём 🐥
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥266
Чтобы документация была нейтральной и её не надо было переписывать c нуля для каждой новой страны:

1. Используйте простые предложения без грамматических перегрузов и специфической лексики.
2. Избегайте локализированных примеров.
3. Размещайте глоссарии к документации.
4. Закладывайте локализацию в архитектуру доки сразу, даже если сейчас кажется, что она никогда не пригодится.
5. Планируйте исследования на локальные аудитории отдельно.

#techdoc
👍144
Почему сторипоинты ценны для оценки задач на техническую документацию?

1️⃣ Учёт различий в навыках
В команде технических писателей навыки и опыт могут значительно различаться. Сторипоинты позволяют учесть эти различия, делая оценки более универсальными и справедливыми.

2️⃣ Гибкость в планировании
Использование сторипоинтов даёт команде возможность гибко планировать свою работу, учитывая сложность задач, а не просто их продолжительность. Это особенно полезно при работе над крупными проектами технической документации, где задачи могут значительно различаться по своему объему и сложности.

3️⃣ Лучшее понимание проекта
Оценка в сторипоинтах требует от команды обсуждения и анализа каждой задачи, что способствует лучшему пониманию проекта в целом и помогает выявить потенциальные риски и неопределенности на раннем этапе.

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

#mngr
Please open Telegram to view this post
VIEW IN TELEGRAM
5👍2👌1
Forwarded from Ozøn Design (Evgenia Marinina)
Media is too big
VIEW IN TELEGRAM
Что общего между UX-редактором и детективом? Кто пишет тексты, которые не читают, а считывают? И как научиться делать тексты для интерфейсов бесплатно без смс? И при чём тут «Гражданская оборона»?

Обо всём этом расскажет Кира Калимулина, руководитель группы UX-редактуры. А ещё картины писать мастер и скейтбордист не слабый (если мы всё правильно поняли)

А ещё от Киры мы узнали, какие профессии сочетает в себе UX-редактор, как писать тексты-проводники и почему сама Кира печатает двумя пальцами. Ответы найдёте в новом выпуске People Tech Ask.

А если хотите знать больше о хороших текстах, то вот вам от Киры:
гайд по UX-текстам
курс по UX-редактуре (пока первое видео, полностью выйдет к лету)
74👍2🦄2🔥1
Типы мотивации

🐱 Внутренняя
Исходит изнутри человека и связана с личным интересом или удовольствием от самой деятельности, а не от внешних поощрений. Например, вы можете изучать новый язык, потому что находите это увлекательным.

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

🐱 Мотивация достижения
Ориентирована на достижение успеха и преодоление препятствий. Люди с высокой мотивацией достижения стремятся к постановке и достижению амбициозных целей.

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

🐱Социальная
Желание поддерживать отношения с другими или принадлежать к группе. Волонтерская работа в сообществе может быть мотивирована желанием внести свой вклад в общее благо.

🐱 Мотивация компетенции
Стремление развивать свои навыки и повышать квалификацию. Профессионал, который постоянно посещает курсы повышения квалификации, вероятно, мотивирован желанием быть компетентным в своей области.

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

#mngr
Please open Telegram to view this post
VIEW IN TELEGRAM
103
У Хабра есть ежегодный конкурс — Технотекст
А теперь у Технотекста есть новая номинация — Подготовка технической документации

И о новой номинации тоже есть статья — Профессия: технический писатель
А в статье есть мнения знакомых вам техписателей 😍

Если у вас были публикации на Хабре за прошлый год, вы ещё успеваете поучаствовать в Технотексте — приём заявок продлили до 14 апреля 🕺

#анонс
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥13🦄32👍2
Я б сказала, что это тариф "Компактный", а не "Выгодный" 😔
Please open Telegram to view this post
VIEW IN TELEGRAM
💯13🙈42
Я: пойду прогуляюсь полчасика, пока погода хорошая.
Клещи: о, мы тоже.
😁20
Искала подкаст на немецком, но свернула не туда.

Поделитесь немецкими блогерами или каналами про изучение языка В1-В2 на ютубе, пожалуйста
😁16👍63
Почему Swagger — это ещё не документация?

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

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

Поэтому Swagger — это классная штука для разработки, но важно завести ещё раздел, который простым языком объясняет а зачем вообще это API надо использовать. И для этого лучше использовать что-то привычное для не-разработчиков. Хотя бы лендинг «Что может этот API» и дальше уже ссылку на Swagger.

Вечный референс для ваших API-док

#techdoc
💯137👌2
Вот представим, что у вас есть свалка вместо документации
А кому-то и представлять не надо, такое тоже бывает

Как свалку действительно превратить в документацию?

Собираем рабочую группу — тут есть варианты из кого и как, но сейчас опустим — и оцениваете каждый элемент свалки по таким параметрам:

🤨 Актуальность
Описана действительная реальность, а не состояние три года назад или фантазии кого-то из сотрудников

👐 Доступность
Легко найти и невозможно потерять — дока ровно там, где она требуется

🐇 Полнота
Документация охватывает все аспекты проекта — без дыр, без разночтений

🤥 Понятность
Тут всё понятно: текст легко понять, в структуре легко ориентироваться

😦 Обновляемость
Процесс обновления документации, включая расписание обновлений и ответственных за них

🙂Обратная связь
Механизм, где читатели могут оставить свои отзывы и сами отзывы


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

Наслаждаемся классной докой 🍿

#techdoc
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥1876💯31