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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Что в итоге

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

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