Пять книг для IT авторов, технических писателей и редакторов

Перечитала недавно книгу «Слово живое и мёртвое» и опять открыла для себя интересные моменты, которые до этого не замечала. Хочу представить вам пять книг, которые действительно полезны для IT авторов, а также полезны техническим писателям, IT редакторам и всем, кто вообще работает с текстом.

Нора Галь «Слово живое и мёртвое»

«Слово живое и мёртвое» это один из интереснейших учебников редактуры. Нора использует термин Корнея Чуковского «канцелярит» и свой собственный термин «суховей» для обозначения казенного, бесцветного стиля. Она сравнивает этот стиль с тяжелой болезнью, которая высушивает живую речь. Нора Галь призывает заменять отглагольные существительные вроде «произошло столкновение» живыми глаголами: «столкнулись». Глагол работает как мотор предложения. Она беспощадно вычёркивает уточнения, которые и так понятны из контекста: не «в месяце мае», а просто «в мае», не «подняться вверх», а «подняться». Автор не против иностранных слов вообще, но против их бездумного использования там, где есть точное и красивое русское слово. Например, зачем «дефект», если есть «изъян» или «недочёт».

Огромная часть книги посвящена тому, как сохранить дух автора при переводе, не превращая живой английский или французский текст в сухой отчёт советского чиновника. Нора Галь советует бережно относиться к переводу. Главный секрет книги в том, что она учит слышать текст. Если фраза звучит как инструкция к пылесосу, хотя вы пишете письмо другу или рассказ, значит, в тексте много мёртвых слов.

Максим Ильяхов, Людмила Сарычева «Пиши, сокращай»

Книга «Пиши, сокращай» выходит далеко за рамки чистки текста. На базе редактуры авторы выстраивают целую систему эффективных коммуникаций. Забота о читателе это главная философия. Писать нужно не для того, чтобы показать свою умность, а чтобы сэкономить время читателя и принести ему пользу. Ильяхов призывает заменять оценки вроде «у нас работают высококвалифицированные специалисты» конкретными фактами: «наши инженеры проходят стажировку в Google». Читатель сам должен сделать вывод, что вы крутые.

Книга учит, как верстать текст. Заголовки, списки, подписи к иллюстрациям, всё это должно работать так, чтобы человек мог просканировать страницу глазами и понять суть, даже не читая основной текст. Иногда, чтобы текст стал лучше, его нужно не сократить, а дописать: добавить подробностей, сценариев использования или примеров, которые сделают абстрактную мысль понятной. Авторы разбирают, как с помощью текста выстраивать доверие, избегать манипуляций и корпоративного булшита, то есть пустых напыщенных фраз. По сути, эта книга современная адаптация идей Норы Галь, применённая к миру интернета, бизнеса и рекламы.

Уильям Зинсер «Как писать хорошо»

Книга Зинсера гораздо шире, чем просто борьба с лишними словами. Если «Пиши, сокращай» это больше про маркетинг и интерфейсы, то «Как писать хорошо» это философия нон фикшн литературы: статей, мемуаров, критики. Зинсер настаивает, что читатель покупает книгу или открывает статью ради вашего взгляда на мир. Он учит не прятаться за безличными фразами вроде «считается» или «было решено», а писать от первого лица, проявляя свой характер. Автор объясняет, как выбрать один ракурс, один тон и один темп для всего текста, чтобы он не разваливался на куски. Конкретные советы: как писать о путешествиях, о науке ^[1] и технике, о бизнесе, о спорте и даже о самом себе. Это делает книгу полноценным учебником для журналистов и писателей. Он рекомендует перечитывать написанное вслух. Текст должен иметь музыкальность: чередование коротких и длинных предложений создаёт нужный темп. Зинсер честно говорит, что писать это тяжело. Это не вдохновение, а бесконечная правка.

Дональд Норман «Дизайн привычных вещей»

Книга когнитивного психолога Дональда Нормана. Это манифест человекоцентричного дизайна. Главная мысль: если вы не можете разобраться, как работает дверная ручка, выключатель или плита, виноваты не вы, а плохой дизайн. Норман объясняет, как психология человека должна определять форму вещей.

Он выделяет четыре фундаментальных принципа взаимодействия. Наглядность: глядя на предмет, человек должен сразу понимать, какие действия с ним возможны. Знаки: подсказки, которые показывают, где именно нужно действовать. Например, плоская пластина на двери подсказывает, что её нужно толкать. Соответствие: логическая связь между органом управления и результатом. Например, правая конфорка включается правой ручкой на плите. Обратная связь: моментальное подтверждение того, что действие выполнено, будь то звук щелчка, индикатор или изменение состояния системы. Норман утверждает, что «человеческих ошибок» не существует, есть только ошибки ^[2] проектирования, которые провоцируют людей действовать неверно. Он вводит два понятия. Пропасть исполнения: это разрыв между тем, что пользователь хочет сделать, и тем, понимает ли он, как это сделать. Пропасть оценки: разрыв между произошедшим событием и пониманием пользователя, что именно случилось.

Нам не нужно помнить всё наизусть, если дизайн предоставляет достаточно информации из внешнего мира: подсказки, формы, ограничения. Хороший дизайн не заставляет пользователя напрягать память ^[3]. В новых изданиях Норман добавил главы о том, почему в реальности появляется плохой дизайн: жёсткие сроки, конкуренция, стремление к низкой стоимости производства. Эти факторы часто мешают сделать продукт удобным. Книга считается библией для UX дизайнеров, но полезна всем, кто хочет научиться замечать неудобство окружающих вещей и понимать, как сделать жизнь проще.

Аркадий Мильчин «Справочник редактора и корректора»

Технический справочник, в котором собраны правила оформления текста. Автор составил единую систему норм для редакторов, корректоров и верстальщиков. В книге нет теории, только готовые ответы на конкретные вопросы.

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

Что в итоге

Советую прочитать эти пять книг и возвращаться к ним по мере необходимости. Каждая из них решает свои задачи.

Книги содержат конкретные инструменты для немедленного применения. Вместе они закрывают практически все вопросы, которые возникают у IT авторов, редакторов или технических писателей.