Хороший рабочий текст

Деньги по своей природе являются общественным отношением.

Виктор Пелевин — «Пространство Фридмана»

Разрозненные фрагменты текста выстраиваются в иерархию от вывода к доказательствам. — Communication Engineering · рабочий текст

Рабочий текст существует внутри отношения: автору что-то нужно от читателя. Даже справка без явной просьбы должна помочь найти ответ. Поэтому качество текста определяется не красотой фраз, а стоимостью правильного действия после чтения.

Сначала контракт

Перед написанием ответьте:

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

Если адресатов несколько, у них могут быть разные маршруты. Руководителю нужен вывод и риск, инженеру — механизм и ограничения, оператору — конкретный алгоритм. Один документ может обслужить всех через слои.

Пирамида

Полезная структура:

вывод или просьба;
главные основания;
детали и доказательства;
приложения и ссылки.

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

Пример начала

Предлагаю перенести запуск на два дня. Интеграционный тест выявил потерю платежного статуса при повторной доставке. Исправление готово, но для проверки нужны полный прогон и сутки наблюдения. Решение требуется до 14:00.

После этого можно объяснять механизм, альтернативы и план.

Заголовки как интерфейс

Заголовок должен отвечать на вопрос раздела. «Информация» хуже, чем «Почему синхронная обработка пока безопаснее». Сканирующий читатель должен восстановить структуру аргумента по заголовкам.

Для короткого сообщения функцию заголовков выполняют первые слова:

Нужно решение до 15:00
Риск релиза
Для информации
Требуется помощь

Конкретность

Абстрактные слова создают ложное согласие:

улучшить;
оптимизировать;
качественно;
удобно;
своевременно;
поддержать.

Заменяйте их наблюдаемыми признаками. Не «быстро отвечать», а «дать первичный ответ в течение рабочего дня». Не «удобный отчёт», а «первый экран отвечает на три вопроса менеджера без экспорта в Excel».

Редактирование

Первый черновик помогает автору думать. Редактура помогает читателю понимать.

Проходы:

удалить всё, что не влияет на цель;
поднять вывод и просьбу;
разделить факт, интерпретацию и рекомендацию;
заменить абстракции примерами;
проверить ссылки, даты, владельцев;
прочитать глазами человека без локального контекста.

Было

«Коллеги, как вы знаете, мы уже некоторое время занимаемся вопросом производительности и после ряда обсуждений хотели бы предложить рассмотреть возможность изменения подхода».

Стало

«Нужно выбрать до пятницы: добавить кэш или принять задержку в 4 секунды. Рекомендую кэш на 10 минут: данные обновляются раз в час, реализация занимает два дня. Риски и альтернатива ниже».

Тон

Прямота не равна грубости. Вежливость не требует прятать просьбу в десяти абзацах. Уважительный текст:

не читает мотивы;
не обесценивает вопрос;
различает срочность и тревогу автора;
даёт возможность отказать или уточнить;
сохраняет человеческое достоинство.

Редакторский проход

Возьми сообщение длиннее десяти строк. Подними решение или просьбу в первые две строки, преврати заголовки в вопросы читателя и сократи текст минимум на четверть без потери критичного контекста.