Получи случайную криптовалюту за регистрацию!

Shut up and write

Логотип телеграм канала @shut_up_and_write — Shut up and write S
Логотип телеграм канала @shut_up_and_write — Shut up and write
Адрес канала: @shut_up_and_write
Категории: Технологии
Язык: Русский
Страна: Россия
Количество подписчиков: 731
Описание канала:

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

Рейтинги и Отзывы

1.67

3 отзыва

Оценить канал shut_up_and_write и оставить отзыв — могут только зарегестрированные пользователи. Все отзывы проходят модерацию.

5 звезд

0

4 звезд

0

3 звезд

0

2 звезд

2

1 звезд

1


Последние сообщения 6

2020-10-02 14:00:20 ​​​Снова про кассу

Нашла в Uniqlo хороший пример визуальной инструкции. У меня уже был пост про инструкцию для кассы самообслуживания и вот опять.

Эта касса отличается от обычной, она сканирует товары сама, вам этого делать не нужно. Зачем при такой магии что-то писать? Потому что иначе никто не узнает, что касса сканирует сама. Я бы действовала как обычно, то есть пыталась бы сканировать вещи по одной, и это бы не сработало.

Что понравилось:
- про оплату картой (это важная информация) написали в самом верху и крупно
- у каждого шага есть цифра и глагол
- картинки помогают, активные объекты подсвечены красным

#бытовуха #примеризжизни
705 viewsShut_up_and_write_bot, 11:00
Открыть/Комментировать
2020-09-28 14:01:01 UPD Random Coffee

На этой неделе встреч не будет, не хватает участников.
Спасибо всем, кто уже присоединился к Random Coffee. Ждем еще неделю, чтобы набрать 50 человек.
552 viewsShut_up_and_write_bot, 11:01
Открыть/Комментировать
2020-09-25 14:01:00 Random Coffee

Random Coffee — это встречи 1-на-1 со случайным человеком. В первый раз я познакомилась с Random Coffee в Яндексе. Потом ходила на такие встречи в Ozon. Я интроверт, но мне такой формат подошел. Потому что мне было интересно узнавать про продукты и работу команд не из постов и пресс-релизов, а лично от коллег. А еще всегда можно было поговорить про документацию.
Теперь я хочу запустить Random Coffee для читателей канала. Для этого я буду использовать бота от Random Coffee.

Как это работает:

1. Желающие подключаются к чат-боту.
2. Ждем, пока соберется 50 человек.
3. Каждый понедельник чат-бот присылает сообщение с именем и профилем партнера по кофе на эту неделю.
4. Вы пишете партнеру по кофе и договариваетесь о созвоне.

Про формат Random Coffee можно почитать на Хабре.
630 viewsShut_up_and_write_bot, 11:01
Открыть/Комментировать
2020-09-11 14:00:44 Лучшая API документация

Оказывается есть целая премия «Лучшие ресурсы для разработчиков» с номинацией «Лучшая API документация». Так как это #запоздалыеновости, то подать заявку со своей документацией не получится, но с 15 сентября можно проголосовать за понравившийся вариант.

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

#makedocumentationgreat
715 viewsShut_up_and_write_bot, 11:00
Открыть/Комментировать
2020-08-14 14:01:07 ​​Про контент-стратегию

Контент-стратегия может восприниматься как термин из сферы маркетинга. Общими словами контент-стратегия — это про планирование и создание контента на основе потребностей пользователей, а контентом может быть что угодно (и посты в Instagram, и Readme на Github).

В контент-стратегию включают очень много разных областей:
- документацию, описание ошибок и интерфейсные тексты
- глоссарий (общий для технических писателей, маркетинга, поддержки)
- проверку на доступность контента
- информационную архитектуру
- карты пути клиента и ментальные модели
- опросы и интервью с пользователями
- маркетинговые исследования рынка

Но это не означает, что контент-стратег делает это все один. Он работает вместе с исследователями, дизайнерами, инженерами, менеджерами, собирает разную информацию и анализирует. В итоге, он составляет план действий, где в продукте нужен контент и в каком формате (готовый ответ для бота, страница в помощи, инфографика, виджет или что-то еще).
Здесь самое место для вдохновляющей цитаты Сары Ричардс (Sarah Richards), контент-дизайнера и основателя Content Design London:

Лучшие продукты создаются там, где люди открыты для совместной работы, чтобы найти лучшие решения. (The best products are created where people are open to working together to find the best solutions.)

А что технические писатели?

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

Что почитать

За один пост я тему не раскрыла, планирую продолжать, а пока вот почитайте:
- Content Design below the surface на Medium. Именно картинку из этой статьи я прикрепила к посту.
- Блог сайта gov.uk.
- Блог Content Design London. Основатель Content Design London Сара Ричардс (Sarah Richards) еще известна тем, что руководила контент-дизайном в gov.uk.

#contentstrategy #точкароста
597 viewsShut_up_and_write_bot, 11:01
Открыть/Комментировать