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