Ноябрь 2019 — Заметка №1

Когда сделал какую-то штуку, то хочется про нее рассказать. Например написать пост в блог. Проблема в том, что такие посты про выпущенные изменения очень легко запороть. Например превратить их в сухое неинтересное перечисление изменений (“теперь по четным дням, когда Сова в Носороге, триангуляция занимает в два раза меньше времени”) или в словообильную жвачку, которая так и не объясняет что изменилось.

Со временем я пришел к тому, что любой пост про фичи можно написать по стандартной жесткой структуре.

Структура выглядит вот так.

1. Вводная часть.
Объясняем в 2-3 предложениях, что мы создали. По сути это краткое саммари всего поста. Если читатель прочитал только эту часть, ему уже должно быть примерно понятно что это за изменение и чем оно хорошо. Например (упрощая для понятности):

У каждого пользователя теперь есть автоматический Кротогон: отпугиватель кротов. Больше не нужно гонять кротов мокрой тряпкой, они cбегут с вашего хозяйства сами.

2. Объясняем ценность изменения.
В этой части мы рассказываем, зачем это изменение. Какую проблему мы решали. Какую ценность это добавляет. В чем уникальность предложения (если она есть). Важно объяснять ценность из мира пользователя: почему ему/ей будет от этого хорошо? Цель этой секции — запитчить изменение пользователю и объяснить ПОЧЕМУ оно хорошее. Например:

Когда заводится крот — горе в хозяйстве. Крот грызет помидоры, шатает столбы, треплет нервы. Гонять крота — сложно, и требует времени. А это время можно было бы потратить на что-то интересное! Наш автоматический кротогон справляется со всем сам: крот собирает чемодан и уходит сам. А вы в свободное время читаете книжку и отдыхаете.

3. Объясняем фичу и ее детали

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

4. Как включить
Объясняем как получить доступ к этим изменениям. Как включить и настроить. Если они появляются у всех автоматически, это надо отдельно проговорить. Например:

Кротогон бесплатен. Получите свой (не больше двух в одно семейство) в ближайшей лавке выдаче, вот карта.”

5. Завершение
Подводим итог и суммируем изменения еще раз. Если недавно были какие-то схожие изменения — можно их упомянуть. Можно пожелать каких-нибудь хороших вещей пользователям, спросить фидбэка или что-то еще подобное. Например:

Кротогон это результат нескольких лет работы нашей лаборотории. Он сэкономит много времени всем своей автоматической кротогонкой. А если совместить его и с Робокопателем, которого мы выпустили в начале месяца, то и вообще не жизнь, а отдых. Желаем вам отличного урожая, пишите письма.

Кто-то может сказать, что мол не слишком ли много про ценность и плюсы? На самом деле нет — такие штуки надо проговаривать снова и снова.

Конечно, такая структура не единственная и можно сделать лучше и по другому. Кто умеет, тому эти советы не нужны. Но если надо что-то написать, а опыта нет — она позволит сделать что-то весьма приемлемое.