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

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

Погнали!

Книгу читала отвратительно долго - 4 месяца (из-за сентябрьских событий)
Книгу читала отвратительно долго - 4 месяца (из-за сентябрьских событий)

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

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

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

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

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

Пример из жизни :)
Пример из жизни :)
3232
54 комментария

Для тех, кто хочет писать хорошие тексты, есть другая книга, которая для меня в свое время оказалась открытием - "Слово живое и мертвое" Норы Галь. Более того, у меня сложилось впечатление, что труд Ильяхова - ее краткая версия, так скажем, адаптация для современного читателя

18
Ответить

Ильяхов и Сарычева не скрывают:

9
Ответить

Ого, спасибо большое за рекомендацию!

Ответить

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

7
Ответить

человек учится,ваша неконструктивная критика не поможет

3
Ответить

Вот главное из вашей публикации, насколько я это понимаю: "В книге авторы описывают подход к информационному стилю письма для тех, кто пишет тексты по работе". Тогда при чем здесь это: "Плохо: Ксюша, привет! Не ровен час нам нужна встреча послезавтра, если у тебя окошки есть. Как считаешь, соберемся на часок?". Хотелось бы посмотреть в глаза этому бизнес-аналитику, который таким вот образом договаривается о деловой встрече))) А "не ровен час" это вообще анахронизм ни к селу ни к городу, который ни по смыслу, ни по каким-то другим причинам здесь зачем-то употребляется.

1
Ответить