«Правильные JIRA issues». Как правильно разбивать задачи на тикеты
Статья на habr о личном опыте автора с тикетами в Jira
И напомню, что любой чужой опыт надо сначала взвесить, а потом бежать внедрять у себя только те части, которые вам помогут и только в той адаптации, которая подходит вашему случаю❤️
#monday_link
Статья на habr о личном опыте автора с тикетами в Jira
И напомню, что любой чужой опыт надо сначала взвесить, а потом бежать внедрять у себя только те части, которые вам помогут и только в той адаптации, которая подходит вашему случаю
#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
Habr
«Правильные JIRA issues». Как правильно разбивать задачи на тикеты
Я сейчас занимаюсь тем, что помогаю акаунту в несколько десятков разработчиков зарелизить проект качественно и в срок. Среди прочего у проекта есть проблема с разбиением задач на тикеты в JIRA. Просто...
✍4🔥3
Что такое #sponsored_by_AI ?
Вообще это немного трёхэтажный процесс постинга всяких текстов😥
Если очень в общих чертах — это тексты, которые пишет ChatGPT по моему очень замороченному промту. Промт зашит в бота, поэтому я просто шлю ему тему или тезисы и он докручивает это до поста. А потом я докручиваю до читаемого текста.
Не всегда до «хорошего текста», стараюсь убить в себе перфекциониста из-за которого в принципе ничего не пишется😐
Вот и получается, что AI как бы даёт основу текста => спонсирует мои полезные лонгриды🐱
Вообще это немного трёхэтажный процесс постинга всяких текстов
Если очень в общих чертах — это тексты, которые пишет ChatGPT по моему очень замороченному промту. Промт зашит в бота, поэтому я просто шлю ему тему или тезисы и он докручивает это до поста. А потом я докручиваю до читаемого текста.
Не всегда до «хорошего текста», стараюсь убить в себе перфекциониста из-за которого в принципе ничего не пишется
Вот и получается, что AI как бы даёт основу текста => спонсирует мои полезные лонгриды
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥5👌2👍1
«Давай скрины добавим, ещё и стрелочками-циферками украсим всякими, чтобы пользователю понятнее было. О, и напишем инструкцию сразу на скрине»
Добавить скриншоты в инструкцию может показаться хорошей идеей, но на самом деле скрины — очень рисковая история.
Основная проблема — поддерживать актуальность скринов очень и очень затратно. Если это скрин вашего продукта — допустимо, но сразу ставьте себе напоминание проверить не поменялся ли интерфейс через пару недель. Если это ещё и чужой сервис — вообще забудьте о скринах. Добавьте ссылку на инструкцию сервиса — писать и обновлять чужие доки задача чужих техписателей, не ваша. Про разные системы, экраны и браузеры вообще молчу.
А если вы переводите доку на несколько языков — умножайте стоимость одного скрина на количество локалей. И ещё на полтора.
Вместо скриншотов лучше рисовать схемы или делать гифки. Но тоже только для своих сервисов!
Они универсальнее, однороднее и нагляднее. Например, анимация может пошагово объяснить пользователю, как использовать приложение или сайт на разных устройствах, что гораздо проще, чем просмотр нескольких скриншотов. А графические схемы и иллюстрации могут быстро объяснить сложные процессы без привязки к текущей версии сервиса.
Если вы все же решили использовать скриншоты
😮 убедитесь, что они соответствуют версии приложения или сайта, которую _используют_ пользователи.
😮 помните о том, что разные устройства могут выглядеть по-разному.
😮 сразу заложите в свои процессы аудит скриншотов через какой-то период времени.
😮 зафиксируйте правила оформления скринов: цвет и толщина выделения; допускаются ли надписи/стрелочки/циферки вообще; в каких сценариях нужны скрины, а где — категорическое нет.
Внимательно оцените все риски и преимущества использования скриншотов. Помните, что ваша главная цель — помочь пользователям, а не запутать их еще больше😤
#sponsored_by_AI
Добавить скриншоты в инструкцию может показаться хорошей идеей, но на самом деле скрины — очень рисковая история.
Основная проблема — поддерживать актуальность скринов очень и очень затратно. Если это скрин вашего продукта — допустимо, но сразу ставьте себе напоминание проверить не поменялся ли интерфейс через пару недель. Если это ещё и чужой сервис — вообще забудьте о скринах. Добавьте ссылку на инструкцию сервиса — писать и обновлять чужие доки задача чужих техписателей, не ваша. Про разные системы, экраны и браузеры вообще молчу.
А если вы переводите доку на несколько языков — умножайте стоимость одного скрина на количество локалей. И ещё на полтора.
Вместо скриншотов лучше рисовать схемы или делать гифки. Но тоже только для своих сервисов!
Они универсальнее, однороднее и нагляднее. Например, анимация может пошагово объяснить пользователю, как использовать приложение или сайт на разных устройствах, что гораздо проще, чем просмотр нескольких скриншотов. А графические схемы и иллюстрации могут быстро объяснить сложные процессы без привязки к текущей версии сервиса.
Если вы все же решили использовать скриншоты
Внимательно оцените все риски и преимущества использования скриншотов. Помните, что ваша главная цель — помочь пользователям, а не запутать их еще больше
#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
👍5🤩4
На прошлой неделе ездили с коллегами на STL Conf — двухдневную конференцию для тимлидов. Хотя доклады там на совсем разные темы)
Посмотреть прошлые выступления на YouTube
Из моих любимых спикеров:
💻 Кирилл Анастасин о публичных выступлениях и личном бренде
💻 Анастасия Абрашитова о специфике работы лидом во внутренней разработке
💻 Юлия Белозерова о выгорании и его проживании
и там ещё миллион всего — смотрите записи и приезжайте на следующие конференции✨
Посмотреть прошлые выступления на YouTube
Из моих любимых спикеров:
и там ещё миллион всего — смотрите записи и приезжайте на следующие конференции
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥7❤2👍1
1. Цель. Процесс непрерывного совершенствования
2. Платформы и экосистемы
3. Джедайские техники. Как воспитать свою обезьяну, опустошить инбокс и сберечь мыслетопливо
4. Настольная книга project-менеджера. Что нужно знать, чтобы управлять IT, digital и другими проектами с учетом российских реалий
5. Мама, я тимлид
6. Как пасти котов. Наставление для программистов, руководящих другими программистами
7. 45 татуировок менеджера. Правила российского руководителя
8. Без обид! Как эмоциональный интеллект помогает общаться с коллегами и руководством
9. Радикальная прямота. Как управлять людьми, не теряя человечности
10. Сложные подчиненные. Практика российских руководителей
11. Все начальники делают это. Пошаговое руководство по решению (почти) всех проблем менеджера
12. Секреты фасилитации. SMART-руководство по работе с группами
Please open Telegram to view this post
VIEW IN TELEGRAM
❤🔥10🔥5👍3🤩2❤1
Целевая аудитория и цель статьи
Авторы технической документации иногда забывают, что их статьи будут читать люди с разным уровнем подготовки. Поэтому важно на старте определить аудиторию и цель статьи, чтобы не написать просто ради того чтобы что-то написать.
Первый шаг — провести исследование. Хотя бы спросите у коллег, для кого, по их мнению, ваша статья. Можно использовать количественные опросы, качественные интервью или смотреть в полях, кто пользуется тем, о чём вы собираетесь написать.
❕ В любом случае важно использовать ясный и простой язык. Избегайте сложных технических терминов и лишних подробностей. Помните, что вас могут читать пользователи без глубокого понимания темы.
Адаптируйте стиль и формат документации под целевую аудиторию. Если вы пишете для начинающих пользователей, объясняйте базовые понятия и используйте простые примеры. Для опытных пользователей вы можете предложить более сложные примеры и фокусироваться на деталях.
🐱 Стройте эмпатию с аудиторией, приводите практические примеры и решения реальных проблем, чтобы помочь пользователям лучше понять материал.
Определить аудиторию техдоки — важная часть создания полезного и понятного контента. Доступность и понятность документации повысят удовлетворенность пользователей и помогут им успешно использовать ваш продукт или сервис
👑 И вдогонку — практическая статья о персонах в документации
#sponsored_by_AI
Авторы технической документации иногда забывают, что их статьи будут читать люди с разным уровнем подготовки. Поэтому важно на старте определить аудиторию и цель статьи, чтобы не написать просто ради того чтобы что-то написать.
Первый шаг — провести исследование. Хотя бы спросите у коллег, для кого, по их мнению, ваша статья. Можно использовать количественные опросы, качественные интервью или смотреть в полях, кто пользуется тем, о чём вы собираетесь написать.
Адаптируйте стиль и формат документации под целевую аудиторию. Если вы пишете для начинающих пользователей, объясняйте базовые понятия и используйте простые примеры. Для опытных пользователей вы можете предложить более сложные примеры и фокусироваться на деталях.
Определить аудиторию техдоки — важная часть создания полезного и понятного контента. Доступность и понятность документации повысят удовлетворенность пользователей и помогут им успешно использовать ваш продукт или сервис
#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
PerfectIt™ | Proofreading Software for Professionals.
How to Understand Your Audience in Technical Writing
Understanding your audience is critical in technical writing. Read our three-step process for tailoring technical content to specific audiences.
✍3👍2🔥1💯1
Статья на vc.ru от руководителя агентства «Сделаем» — ребята делают классные тексты так и ещё и объясняют, почему какой-то текст классный, а какой-то — не очень.
В статье хорошо прошлись по базовым принципам. Касается не только текста о компании, но и в целом текстов хоть статьи, хоть блога
#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
vc.ru
О чем писать на сайте, если хочешь нормальный текст, а не «Мы молодая динамично развивающаяся компания»
В статье рассказываю, как достать классную фактуру для вашего сайта, не вымучивать текст и не заливать будущих читателей водянистой водой.
👍6
Издательство Inspiria устраивает этим летом серию встреч в московских барах. Каждый вторник — новое место и новая книга к обсуждению.
Вчера говорили о «В омут с головой» — для меня остаётся вопросом насколько это автофикшн, но сам стиль автора и его адаптация на русский очень цепляют. Ну и сюжет, да. Потому что некоторые мысли очень откликались мне лично, а с учётом подачи — держали меня на крючке все два часа чтения.
Книга следующей недели — «Улица милосердия» ✨
фоточки со вчера
Вчера говорили о «В омут с головой» — для меня остаётся вопросом насколько это автофикшн, но сам стиль автора и его адаптация на русский очень цепляют. Ну и сюжет, да. Потому что некоторые мысли очень откликались мне лично, а с учётом подачи — держали меня на крючке все два часа чтения.
Книга следующей недели — «Улица милосердия» ✨
🔥5👍2❤1
Управление конфликтами
🤬 Чувствуете, что в вашей команде начинают накапливаться конфликты? Не откладывайте разрешение проблемы на потом, ведь отсутствие действий может серьёзно повлиять на работу вашей команды.
В этом посте рассмотрим несколько важных шагов, которые помогут вам управлять конфликтами и создать благоприятную атмосферу сотрудничества
🥺 Первый шаг к успешному управлению конфликтами — понять их причины. Конфликты могут возникать из-за различий во взглядах, ценностях, интересах или личностях участников команды. Если вы поймёте, какие факторы могут вызывать конфликты в вашей команде, вы сможете принять меры для их предотвращения.
🤓 Следующий шаг — применять систематический подход к разрешению конфликтов. Не стоит надеяться на то, что конфликты решатся сами по себе или с помощью случайных действий. Разработайте план действий, который будет включать в себя шаги по идентификации конфликта, анализу причин, поиску взаимоприемлемых решений и обсуждению результатов.
📞 Ключевой аспект управления конфликтами — коммуникация. Важно создать открытую атмосферу, в которой каждый участник команды может выразить своё мнение и почувствовать, что его точка зрения принимается во внимание. Умение слушать, выражать свои мысли чётко и конструктивная критика помогают снять напряжение и найти взаимоприемлемое решение.
😊 Не забывайте о значимости эмпатии. Умение поставить себя на место других участников команды поможет лучше понять их потребности и причины их действий. Эмпатия способствует снижению конфликтов и повышению взаимопонимания в команде.
#sponsored_by_AI
В этом посте рассмотрим несколько важных шагов, которые помогут вам управлять конфликтами и создать благоприятную атмосферу сотрудничества
#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥3👌2❤1🤡1
Ссылки на что вы бы хотели видеть по понедельникам? Думаю переключиться со статей на какие-то видео: на какие? Стоит ли?
Что вообще смотрите вне телеги? Какие ресурсы, какие темы?
Please open Telegram to view this post
VIEW IN TELEGRAM
Очередное продуктивное приложение с одной стороны
С другой — нетривиальная идея и статья о продуктовом процессе за этим приложением
Что понравилось
👌 у автора свой подход к планированию — я такое люблю, а не просто натягивание чужих фреймворков
👌 в статье есть анализ почему пошло не по плану
👌 приложение продолжает адаптироваться под фактические запросы аудитории
#monday_link
С другой — нетривиальная идея и статья о продуктовом процессе за этим приложением
Что понравилось
#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
👍5
Пока подаю заявки на конференции и жду в себе смелости анонсировать те, куда меня уже приняли, держите инструкцию по подготовке докладов 🐈⬛
1. Прикинуть аудиторию и основной посыл своего доклада: что хотелось бы донести и до кого.
2. Набрать свалку из всего-всего по теме. При чём сама свалка вам больше не пригодится, скорее всего, но откалибрует ваш взгляд на проблему.
3. Составить примерную рыбу доклада. Прям очень поверхностно — вот тут это расскажу, сюда картинку с котиком добавлю, а здесь блок для вопросов.
🐈⬛ 4. Пойти и об кого-то подумать пункты 1 и 3. Внести правки, вывести окончательную тему и структуру.
5. Наполнить презентацию "мясом" — текстом, графиками, мемасиками etc. Это всё ещё черновой этап, не пытайтесь сделать всё.
6. Рассказать сами себе, можно записать на видео. Например, как сделал Кирилл Анастасин. Пересматривать необязательно, все проплешины всплывут в процессе.
7. Рассказать кому-то, желательно и людям из четвёртого пункта.
🐈⬛ 8. Внести финальные доработки, отрепетировать ещё пару раз перед зеркалом.
9. Подготовить список полезных материалов, которыми можно поделиться с аудиторией после доклада.
🐈⬛ Лайфхак: можно отдельные куски доклада прогонять на командных созвонах. И коллегам что-то полезное расскажете, и мнения услышите.
🐈⬛ Варнинг: слишком много мнений тоже вредно, ищите свою золотую середину в каждом пункте
1. Прикинуть аудиторию и основной посыл своего доклада: что хотелось бы донести и до кого.
2. Набрать свалку из всего-всего по теме. При чём сама свалка вам больше не пригодится, скорее всего, но откалибрует ваш взгляд на проблему.
3. Составить примерную рыбу доклада. Прям очень поверхностно — вот тут это расскажу, сюда картинку с котиком добавлю, а здесь блок для вопросов.
5. Наполнить презентацию "мясом" — текстом, графиками, мемасиками etc. Это всё ещё черновой этап, не пытайтесь сделать всё.
6. Рассказать сами себе, можно записать на видео. Например, как сделал Кирилл Анастасин. Пересматривать необязательно, все проплешины всплывут в процессе.
7. Рассказать кому-то, желательно и людям из четвёртого пункта.
9. Подготовить список полезных материалов, которыми можно поделиться с аудиторией после доклада.
Please open Telegram to view this post
VIEW IN TELEGRAM
👍11❤6💯3⚡1🔥1
Привет! Довольно много людей подписалось в последние недели, поэтому
Привет, я Катя🐸
Скорее всего мы познакомились на обучении ЦЕХ или вы слушали подкаст в Техпис Говорит🐸
Или же мы увидимся на Стачке 15-16 сентября и поговорим о документации лично🐸
В любом случае — если есть что-то, чем я могу быть полезна — может, вы давно хотели узнать больше о техписателях, управлении командами, яхтинге, корейском языке, поездках или чём угодно другом — пишите в комментарии или в личные сообщения🐸
🐸 Самые популярные посты so far 🐸
Подборка книг для тимлидов
Почему со скринами в доке надо осторожно
Как стать хорошим техписателем
Подборка базовых материалов для текстоделов
Привет, я Катя
Скорее всего мы познакомились на обучении ЦЕХ или вы слушали подкаст в Техпис Говорит
Или же мы увидимся на Стачке 15-16 сентября и поговорим о документации лично
В любом случае — если есть что-то, чем я могу быть полезна — может, вы давно хотели узнать больше о техписателях, управлении командами, яхтинге, корейском языке, поездках или чём угодно другом — пишите в комментарии или в личные сообщения
Подборка книг для тимлидов
Почему со скринами в доке надо осторожно
Как стать хорошим техписателем
Подборка базовых материалов для текстоделов
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥10❤🔥4🙏1🐳1
Насмотренность
Одно из важнейших качеств хорошего писателя — насмотренность на тексты
😵💫 Насмотренность — это способность внимательно и с интересом изучать разнообразные тексты. Это может быть всё что угодно: книги, статьи, блоги, рекламные листовки — главное, чтобы мы могли увидеть, что в них хорошо, а что — не очень.
👾 Насмотренность позволяет нам лучше воспринимать информацию. Когда мы читаем много текстов, наше внимание и концентрация тренируются, поэтому читать становится легче.
👾 Чтение примеров хорошего и качественного текста помогает нам лучше понять, как эти тексты построены, какой стиль использован, какие приёмы и методы можно использовать. Мы учимся быть более точными, чёткими и выразительными в своих собственных текстах.
👾 И, как следствие, насмотренность развивает наш собственный стиль письма. Когда мы видим разные подходы авторов, разные стили и тон, мы можем выбирать, что нам нравится и что соответствует нашей индивидуальности. Постепенно мы развиваем свой уникальный стиль, который помогает выделиться среди других писателей и улучшает наши тексты.
🤤 Поэтому, если вы хотите стать более эффективным в письме, не забывайте тренировать свою насмотренность:
🥺 читайте разнообразные и качественные тексты,
🥺 изучайте разные стили и приемы,
🥺 обратите внимание на то, как другие авторы выражают свои мысли.
#sponsored_by_AI
Одно из важнейших качеств хорошего писателя — насмотренность на тексты
#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥8💯2
как я могу помочь?
за последний месяц я написала эту фразу намного больше раз, чем хотелось бы
и я полностью понимаю, что люди в тех ситуациях, скорее всего, ничего конкретного мне не скажут
как я могу помочь? — это вместо просто обнять, просто взять за руку, просто помолчать
но просто помолчать на расстоянии сложно
поэтому приходится снова спрашивать
как я могу помочь?
за последний месяц я написала эту фразу намного больше раз, чем хотелось бы
и я полностью понимаю, что люди в тех ситуациях, скорее всего, ничего конкретного мне не скажут
как я могу помочь? — это вместо просто обнять, просто взять за руку, просто помолчать
но просто помолчать на расстоянии сложно
поэтому приходится снова спрашивать
как я могу помочь?
❤🔥22💔3
Один из моих основных тезисов о том, что подходов и мнений много, но
надо знать как можно больше подходов и мнений, чтобы выбрать из них те элементы, которые подходят конкретно тебе в конкретно твоей ситуации
Поэтому держите ещё один подход к управлению командами
🐱 Управление как игра
надо знать как можно больше подходов и мнений, чтобы выбрать из них те элементы, которые подходят конкретно тебе в конкретно твоей ситуации
Поэтому держите ещё один подход к управлению командами
Please open Telegram to view this post
VIEW IN TELEGRAM
Digital агентство JetStyle
Управление как игра
В этой статье мы поговорим о том, как строится коллектив, кого надо брать на работу, почему люди что-то делают и как найти ключик к конкретному человеку.
🔥3❤2👌1
New Jeans вдохновлялись рабочими чатами продакт-менеджеров?.)
Вчерашний релиз: ETA
И сегодняшний: ASAP
Вчерашний релиз: ETA
И сегодняшний: ASAP
YouTube
NewJeans (뉴진스) 'ETA' Official MV (Performance ver.)
NewJeans (뉴진스) 'ETA' Official MV (Performance ver.)
Producer: MIN HEE JIN
Music Video Director: Wooseok Shin
© 2023 ADOR. All Rights Reserved.
Connect with NewJeans
PHONING https://phoning.onelink.me/KG15/n7452q87
OFFICIAL YOUTUBE https://www.youtube…
Producer: MIN HEE JIN
Music Video Director: Wooseok Shin
© 2023 ADOR. All Rights Reserved.
Connect with NewJeans
PHONING https://phoning.onelink.me/KG15/n7452q87
OFFICIAL YOUTUBE https://www.youtube…
😁5
Что общего между программистами, дизайнерами и писателями?
Ответ не очевиден: с появлением технических писателей они найдут общий язык.
⏺ Технические писатели — это профессионалы, которые специализируются на создании понятного и доступного технического контента.
Они создают документацию для продуктов и сервисов, которая помогает пользователям разобраться в функциональностях и возможностях. Важный навык для техписателя — уметь общаться как с разработчиками, для получения необходимой информации, так и с пользователями, чтобы перевести сложные технические термины на понятный язык.
⏺ Технический писатель может работать и с внутренней командой разработки, облегчая коммуникацию и совместную работу, и с внешними пользователями, помогая им легче адаптироваться к продукту или сервису.
Важно понимать, что работа технических писателей важна не только для разработчиков, но и для привлечения и удержания клиентов. Качественная и понятная документация может стать преимуществом компании и помочь ей занять лидирующую позицию на рынке.
🖇 What does a Technical Writer Do?
#sponsored_by_AI
Ответ не очевиден: с появлением технических писателей они найдут общий язык.
Они создают документацию для продуктов и сервисов, которая помогает пользователям разобраться в функциональностях и возможностях. Важный навык для техписателя — уметь общаться как с разработчиками, для получения необходимой информации, так и с пользователями, чтобы перевести сложные технические термины на понятный язык.
Важно понимать, что работа технических писателей важна не только для разработчиков, но и для привлечения и удержания клиентов. Качественная и понятная документация может стать преимуществом компании и помочь ей занять лидирующую позицию на рынке.
#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
YouTube
What Does a Technical Writer Do?
If you're interested in learning more about what a technical writer does, then download our syllabus to the technical writing courses that we provide on Technical Writer HQ: https://technicalwriterhq.com/
A technical writer is someone who writes company…
A technical writer is someone who writes company…
🔥6👨💻2❤1
Если вы ещё не проводите 1-1, то эти 40 шаблонов идут к вам:
https://templatelab.com/one-to-one-meeting/
А если проводите — они всё равно к вам идут с новыми идеями💡
#monday_link
https://templatelab.com/one-to-one-meeting/
А если проводите — они всё равно к вам идут с новыми идеями
#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
TemplateLab
40 Best One to One Meeting Templates (100% Free)
Engaging, listening, and sharing feedbacks with team is very important for managers. Download one to one meeting templates from our website.
🔥10👨💻1
Избыточная детализация доки
Что может быть хуже, чем пытаться разобраться в запутанной технической документации? Избыточная детализация может быть настоящей головной болью для пользователей, которые пытаются разобраться в продукте или решить проблему.
При написании технической документации нет необходимости вдаваться во все детали и мелочи, которые могут только запутать пользователей. Возможно, вы отлично знаете все характеристики и функции своего продукта, но пользователи обычно ищут простые и понятные ответы на свои вопросы. Или они хотят быстро ознакомиться с возможностями продукта, не тратя много времени на чтение длинной документации.
Излишняя детализация не только затрудняет чтение, но и может привести к неправильному использованию продукта. Пользователь может запутаться во множестве технических терминов или не суметь разобраться, что именно ему нужно сделать.
Это может привести к негативному опыту использования продукта и даже к его возврату или негативным отзывам.
Чтобы избежать этой проблемы, рекомендуется рассмотреть аудиторию, для которой была написана документация. Подумайте о том, какой уровень знаний у ваших пользователей и что они ожидают найти в документации. Адаптируйте свои материалы под их потребности и предоставьте только необходимую информацию.
Краткость и ясность — вот ключевые принципы, которых следует придерживаться при написании технической документации. Она должна быть понятной и доступной даже для тех, кто не имеет специального образования. Если пользователь может быстро найти нужную информацию и понять, каким образом использовать продукт, это повысит его удовлетворенность и вероятность повторной покупки.
Помните, что техническая документация не должна быть скучной и сложной. Она должна быть полезной, понятной и помогать пользователям в использовании продукта без лишних затруднений.
#sponsored_by_AI
Что может быть хуже, чем пытаться разобраться в запутанной технической документации? Избыточная детализация может быть настоящей головной болью для пользователей, которые пытаются разобраться в продукте или решить проблему.
При написании технической документации нет необходимости вдаваться во все детали и мелочи, которые могут только запутать пользователей. Возможно, вы отлично знаете все характеристики и функции своего продукта, но пользователи обычно ищут простые и понятные ответы на свои вопросы. Или они хотят быстро ознакомиться с возможностями продукта, не тратя много времени на чтение длинной документации.
Излишняя детализация не только затрудняет чтение, но и может привести к неправильному использованию продукта. Пользователь может запутаться во множестве технических терминов или не суметь разобраться, что именно ему нужно сделать.
Это может привести к негативному опыту использования продукта и даже к его возврату или негативным отзывам.
Чтобы избежать этой проблемы, рекомендуется рассмотреть аудиторию, для которой была написана документация. Подумайте о том, какой уровень знаний у ваших пользователей и что они ожидают найти в документации. Адаптируйте свои материалы под их потребности и предоставьте только необходимую информацию.
Краткость и ясность — вот ключевые принципы, которых следует придерживаться при написании технической документации. Она должна быть понятной и доступной даже для тех, кто не имеет специального образования. Если пользователь может быстро найти нужную информацию и понять, каким образом использовать продукт, это повысит его удовлетворенность и вероятность повторной покупки.
Помните, что техническая документация не должна быть скучной и сложной. Она должна быть полезной, понятной и помогать пользователям в использовании продукта без лишних затруднений.
#sponsored_by_AI
🔥8👌2❤1
А ещё можно использовать промокод «Ушакова», чтобы купить билет со скидкой 10% ✨
Please open Telegram to view this post
VIEW IN TELEGRAM
❤🔥3