Литература для бизнес-аналитиков. Обзор книги «Пиши, сокращай»

Всем привет! Продолжаю серию обзоров литературы для БА. На очереди у нас популярная книга «Пиши, сокращай» Максима Ильяхова и Людмилы Сарычевой.

Погнали!

Disclaimer: Описанный текст является моим личным мнением и интерпретацией. В статье приведены мысли и тезисы, которые я перекладываю на специфику работы аналитика в IT. Погнали!

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

Что можно почерпнуть из идей?

1. Текст должен быть простым.
   Поможет упрощение предложений.
   Убирать всякий мусор, где не нужно: стоп-слова, вводные конструкции, синонимы. Избегать слова «Кстати», оценок (субъективных ощущений).
   Пример:
   Плохо: Кстати, страница авторизации должна содержать еще и красивый фильтр с тремя вариантами ответов.
   Нормально: Страница авторизации содержит фильтр с тремя вариантами ответов: да, нет, пусто.
2. Проверять и перечитывать текст на слух.
   Помогает избавиться от глупых ошибок. Вроде банальный совет, но мы-то с вами знаем, как часто перечитываем в цейтноте свои требования, да?
   Требования лучше читать вслух через пару часов, как они написаны и переписывать все то, где спотыкаешься или непонятно.
3. Убирать штампы. Бытовые, корпоративные, газетные.
   Для требований — не самый подходящий совет, а вот при общении с заказчиком писать лучше кратко и по делу.
   Пример:
   Плохо: Ксюша, привет! Не ровен час нам нужна встреча послезавтра, если у тебя окошки есть. Как считаешь, соберемся на часок?
   Нормально: Ксюша, привет! В среду 17.03 нужна часовая встреча с тобой для обсуждения макетов. Когда у тебя есть свободный слот?
4. Избегать формализма и неопределенности. Использовать простые слова.
   Часто замечаю в требованиях у себя и коллег. Кажется, что если написать заумно — все оценят твой серьезный подход к делу. Когда суть-то в том, чтобы требование прочли и поняли (и сделали). Если не знаешь слово — не писать, если хочется козырнуть терминологией — подумать о джуне (недавно пришедшему на проект), которому дадут ваши требования для маленькой задачи. Он их будет неделю страдать и читать, а задачу делать месяц. Спасите жизнь вашим коллегам!
   «Лучше просто о сложном, чем умно о ерунде» (с.)
   Пример:
   Плохо: в разрабатываемой системе необходимо добавить раздел «Зевота» с обновляемым фильтром «Скукотища», который будет содержать в себе весь перечень существующих в системе справочников городов.
   Нормально: В системе появляется раздел «Зевота« и фильтр »Скукотища». Состав фильтра: справочник городов, существующих в системе. Фильтр обновляется раз в сутки в 23:59 (utc0).
5. Одно предложение — одна мысль.
   Если нужно описать что-то новое — лучше описывать одну-две мысли в предложении. Если тема знакомая, то допустимо описать три.
   Пример:
   Для новичков: Альфред — программа для управления компьютером.
   Для подготовленных читателей: Альфред — программа для дистанционного управления компьютеров на MacOS и Linux.
6. Предложения должны быть короткими.
   Если вам нужно несколько раз набирать воздух в легкие, чтобы прочесть длинное — предлинное предложение, которое так и хочется сократить скорее — поскорее, это плохое предложение, которое может содержать слишком много ненужных слов, а дышать все сложнее и сложнее…
   Лучше использовать короткие предложения. Но. Не. Такие. Где. Мы. Пропускали. 1 класс и тему запятые. В школе.
   
7. Не писать несколько предложений в одном.
   Например, если в предложении есть явная/неявная связь. Такие предложения лучше разделять.
   Пример:
   До: Система содержит в себе 5 разделов, в результате работы с разделами вы получите полный перечень информации про мышей.
   После: Система содержит в себе 5 разделов. Результатом вашей работы с разделами является полный перечень информации о мышах.
8. Использовать структуры внутри текста: абзацы, модули, подзаголовки
   Тут все просто: одна тема — один абзац. Подзаголовок внутри статьи подсказывает, что будет написано в модуле/абзаце/блоке требований. Сплошной текст сложно читать всем, а по подзаголовкам можно быстро пройтись по тексту.
9. Добавлять иллюстрации в текст.
   Достаточно распространенная практика — прикреплять картинки к требованиям, но если у вас минимум макетов — можно нарисовать прототипы или небольшие схемы. Визуально картинка разделяет сплошной текст, делая его более интерактивным и привлекательным.

Моя оценка книге: 7,5/10. Часть информации я знала и так, но было полезно заново прочесть и подчерпнуть что-то новое, книга была мне полезна.
Минус: авторы хоть и пытались сделать книгу более яркой и читабельной, я наоборот отвлекалась от основной мысли в тексте и бегала по предложениям туда-сюда.
Второй раз перечитывать не буду, но но может оно пока и не надо: )