6 Подписчиков

Shut up and write

Технологии

Я Маша и я технический писатель. Очень люблю документацию, особенно хорошую. Читаю все подряд: инструкции к стиральным машинам, правила пользования метро и справки разных сервисов. На канале пишу о том, что понравилось или не понравилось.

Последние посты

   Shut up and write

Shut up and write

​Специалист по управлению знаниями (Knowledge manager) — это одна из ролей, которую технический писатель может выполнять. Но иногда писатели даже не знают, что управляют знаниями, и о том, как это важно для компании. А в это время где-то за рубежом ищут таких специалистов, например, чтобы оценивать, способы распространения информации, развивать и улучшать обмен знаниями в рамках всего бизнеса или повышать удовлетворенность клиентов. 26 апреля в Москве пройдет конференция по управлению знаниями в IT компаниях KnowledgeConf 2019. Еще можно успеть подать заявку на доклад или купить билет. Хороший пост о конференции на habr.

   Shut up and write

Shut up and write

Опубликовали презентации с митапа Positive Authoring Tools Battle: https://storage.ptsecurity.com/d/c7ff689672464c1cbe8f/

   Shut up and write

Shut up and write

​Документация — это не только Word, но другие инструменты. 👩‍💻 Мы пробуем Slate для документации API. Об этом я буду рассказывать на митапе Positive Authoring Tools Battle. Спойлер. Сейчас мой день выглядит так:

   Shut up and write

Shut up and write

Осторожнее с автопереводами. Китайский магазин vova.com в своем мобильном приложении поможет вам выбрать товары для человека или для женщины🙈

   Shut up and write

Shut up and write

​Пользователи часто не читают документацию. Но если пользователи не идут к документации, то документация должна идти к пользователям!☝️ Рабочий пример Сотрудники нашей компании пользуются специальными принтерами для печати этикеток — Zebra. У Зебр есть подробная документация с картинками на 100 страниц, а на сайте есть даже видеоинструкции. Но их реальные пользователи не готовы читать, не готовы смотреть. И я их понимаю. 🙅 Решение У нас частым кейсом была очистка валика. При этом фиксатор валика терялся. Мы сделали инструкцию типа комикс под размер принтера. Картинки взяли из официальной документации (так было быстрее). Теперь инструкция хранится на принтере и ее нельзя пропустить, а так как текста там почти нет, то и читать ее не надо. Profit🙌

   Shut up and write

Shut up and write

​Aviasales заботливо по ночам включает темную тему. Приятно, когда создатели сайта тебя понимают. С другой стороны, я редко бываю на их сайте и не вспомнила бы его цвет, если бы мне не напомнили сообщением. Получается такая задокументированная забота. Зато сообщение написано по-человечески. Спасибо за заботу, Aviasales😴

   Shut up and write

Shut up and write

Какой должна быть инструкция для светильника? Конечно понятной и с минимумом слов. Ну не хочет никто уже читать, особенно когда подгоняют заказчики со своим ремонтом. 😝 Вот вам прекрасный pdf от Centrsvet https://www.centrsvet.ru/media/uploads/p.d.f/sft_dtw_f_w_instr.pdf. Что бы я поменяла: 1. Добавила циферки для этапов. Визуально поможет понять последовательность. 2. Поправила слова. Подготовка к установке => Подготовка, Завершение установки => Установка. 3. И еще поправила слова. Фраза «Установка светильника осуществляется при выключенной электрической сети» меня пугает тем, что я прочитала ее неправильно. Слишком много сложных и длинных слов. Я бы написала: «Выключите электричество перед установкой». Итого: У меня получилось вот так https://yadi.sk/i/__qKsu6n0vV4zA

   Shut up and write

Shut up and write

Не пишу посты, зато до конца прошла тренажер Ильяхова по развитию навыков верстки http://maximilyahov.ru/trenazher 💃 Ради такого стоит проходить🔥

   Shut up and write

Shut up and write

Пока кто-то из нас вчера следил за презентацией Эппла, на которой, по-моему, не было ничего особенно интересного (ну разве что часы научились снимать ЭКГ), Убер показал свой новый брендинг. Вот где красота. Настоящий ребрендинг — это не только внешние изменения. Не новые иконки и шрифты. Настоящий ребрендинг — это следствие изменений внутри, в ценностях и процессах компании. Убер сейчас переживает глубокий кризис. Компании пока так и не удалось оправиться от всех скандалов и отставки Трэвиса Каланика. Репутация Убера в Долине всё ещё ниже плинтуса. Так что им как никогда нужны изменения и свежая перспектива. Не все знают, что Убер — компания не про заказ машины. Их амбиции всегда были намного бóльшими. Убер хочет переизобрести перевозку всего и всех. Людей в городе и между городами, еды, товаров, грузов. Убер — это логистическая компания в самом широком смысле, и именно поэтому она стоит баснословные 72 миллиарда (семь Яндексов!). Новый бренд сделан внутренней бренд-студией вместе с Wolff Olins. Своя бренд-струдия — это тренд. Так же как дизайн продуктов в продуктовых компаниях сейчас всегда делается внутри. Такие вещи просто невозможно делать силами подрядчиков. Это неотъемлемая часть бизнеса, которая живёт и развивается вместе с ним. Внешне новый Убер сделали очень трендовым. Белый фон, крупный круглый кастомный чёрный шрифт, синие акценты, простые иллюстрации и фотки. Где-то мы всё это уже видели. Примерно у всех стартапов, которые хотят своим внешним видом сказать, что они модные и технологичные. Писал про это заметку год назад: t.me/desprod/82. Любопытно, что за год изменилось не так уж и много. Стало меньше иллюстраций и больше фотографий, да ярко-тёмно-синий окончательно всех победил в качестве Главного Цвета. Много классных находок в графике. Широкие белые поля у билбордов и плакатов как будто образуют букву U. Знака нет вообще — вместо него текстовый логотип. Главное применение знаков у технологических компаний сейчас — иконка приложения. Убер предлагает чёрную иконку с белым текстом. А ещё мне очень нравится как в рекламной коммуникации используют простую стрелочку вправо. Привет гениальному бренду FedEx. Классно видеть контент-дизайн — tone of voice — неотъемлемой частью бренда. То, какими именно словами и с какой интонацией компания общается с нами, определяет ощущения в неменьшей степени, чем графика. Но как часто при этом в портфолио дизайн-студий в рассказах про брендинг мы видим гайдлайны по стилю письма? Не могу тут не сказать, что мне очень нравится язык Яндекс.Драйва, один из самых ярких примеров сильной работы с текстом на русском языке. Новый бренд сам по себе, конечно, не спасёт Убер. Но приятно видеть, что у компании ещё есть порох. Все подробности про новый бренд Убера тут: https://www.uber.design/case-studies/rebrand-2018 P. S. Кстати, у Яндекс.Такси бренд ничуть не слабее, а то и посильнее будет. Им даже слова не нужно писать, чтобы обозначить себя, — достаточно покрасить машину, билборд или любой другой объект. Простой язык с бесконечными возможностями использования.

   Shut up and write

Shut up and write

Пост про дизайн, но не просто про картиночки. Про важность текста в дизайне😊 То, какими именно словами и с какой интонацией компания общается с нами, определяет ощущение в неменьшей степени, чем графика. (с) ❤️❤️❤️❤️

   Shut up and write

Shut up and write

​А сам автомат для тренировки ловкости, глазомера и чего-то еще выглядит так:

   Shut up and write

Shut up and write

​​Я предупреждала, что читаю все подряд. Вот мой фаворит на сегодня. Инструкция к автомату с игрушками. 🎰 В такой автомат я играла в детстве, но я даже не знала, что это "Симулятор механического тира для развития ловкости, координации и глазомера". Джунгли зовут, короче.🐨 Но это не страшно, и даже не отсутствие запятых. Вроде даже все прилично для игрового автомата. Пошаговая инструкция: заплати, выбери игрушку и жми на кнопку.🕹 Но с пункта 5 все начинает портиться, пункт 6 страшно читать. Почему это вообще пункт с цифрой? Все закончилось на шаге 5. Я просто процитирую чуть-чуть: Вежливо просим принять во внимание, что пользуясь нашим тиром, Вы в первую очередь тренируете и развиваете Ваши способности по ловкости, координации и глазомеру и при достаточности данных умений Вы сможете....Тренировка на нашем симуляторе .... основана исключительно на Ваших физических и интеллектуальных способностях....(с) Но этого им мало, есть еще пункт 7: Лиц, желающих испытать остро выраженное чувство азарта, основанное на неопределенности наступления выигрыша настоятельно просим не принимать участие в тренировках....(с) Понимаю, что этот текст как-то предписан законом. Типа мы не казино, мы тренажер. И никто, кроме ответственных служб это не читал, но как?!😰 #бытовуха

   Shut up and write

Shut up and write

​Можно сказать, что ребят из госорганов понесло в такой "легкий формат". 👯 Раньше на вопрос: "Как получить актуальную информацию из телика?" Я бы ответила: "Никак". Но теперь я знаю секрет. Благодаря это простой инструкции.💪 И да, тут тоже картинки, типа комикс. Я же говорила.🤓 А вот в той части, где про службу поддержки, с картинками плохо. Какие-то стрелки на какие-то куски интерфейса. Очень похоже, что делали разные люди. 😵 Картинка с девушкой мне вообще напоминает стикер 💁, но думаю они хотели что-то другое нарисовать. #непогосту

   Shut up and write

Shut up and write

​Конечно нужно посмотреть весь плакат, чтобы понимать контекст👁

   Shut up and write

Shut up and write

​В тему вчерашнего поста про инструкции-комиксы. Уже даже ̶с̶а̶м̶ы̶е̶ ̶о̶т̶с̶т̶а̶л̶ы̶е̶ госорганы используют комиксы. Вот пример прямиком с двери моего подъезда. Рассказывают, как голосовать правильно. Оказывается весь секрет в завтраке!🍳

   Shut up and write

Shut up and write

Хотела писать набросы в этот канал, но пока не выходит. Поэтому буду петь оды гениальному — это документация в комиксах👾. Как такое возможно?! Кому это нужно?! Всем:) 🤒Это снижает градус. Можно рассказывать серьезные вещи взрослым людям в комиксе. И люди даже не догадаются, что вы им впарили инструкцию, но в подкорке уже все будет. Магия! 🔥Теперь нужны жгучие примеры, которые доказывают, что я права. Тут на помощь призывается Т—Ж. Вот вам комикс про льготную ипотеку https://j.tinkoff.ru/tg/putin-obeschal/ (урл просто космос, надеюсь это законно). Коротко и с юмором рассказали про сроки и размер кредитной ставки. ☄️Еще один пример — нарратив про Алису в Дзен https://clck.ru/E5eNW. Осторожно, в Дзене можно зависнуть надолго. 🔧И конечно, Икея — мастер комиксов про сборку мебели. У них +100500 разных, можно посмотртеть на сайте http://service.ikea.ru/visit/buying-guides/. Мой любимый не про мебель https://clck.ru/E5fXy. 💁Да, в формате комикса не расскажешь всех тонкостей, но их можно описать после, если надо. Или использовать комикс, чтобы закрепить основные шаги. 👀Смотрите, вдохновляйтесь и ̶в̶о̶р̶у̶й̶т̶е̶ создавайте что-то новое. #непогосту

   Shut up and write

Shut up and write

Начинать надо с хорошего. И я начну с чудесного письма от Skyscanner. Пишут про такую нудную вещь, как политика конфиденциальности. Это то, что никто не читает, а просто ставит галочку "Принять". Так вот, в письме есть все, что мне нравится: простой язык + забота о читатели. Они понимают, что эти политики никто не читает и прямо про это пишут☺️ А еще они сделали краткое содержание этой политики. Это как в школе с романом Войну и мир. Святые люди, спасибо вам😇 #любовныеписьма

   Shut up and write

Shut up and write

Волшебное письмо от команды Skyscanner

   Shut up and write

Shut up and write

На канале буду писать о том, что понравилось или не понравилось. Постараюсь быть конструктивной и предлагать свои варианты😜

   Shut up and write

Shut up and write

Привет! Я Маша и я технический писатель. Я уже 10 лет работаю в IT и 8 из них пишу документацию. Я очень люблю документацию, особенно хорошую. Читаю все подряд: инструкции к стиральным машинам, правила пользования метро и помощь сервисов, которыми пользуюсь.