Блог технического писателя Ильи Жукова

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

Уважаемые коллеги! Сегодня хочу рассказать вам о книге Уильяма Зинсера "Как писать хорошо". На первый взгляд, она не имеет ничего общего с разработкой справки и пользовательской документации. Но меня привлек подзаголовок "Классическое руководство по созданию нехудожественных текстов" и оказалось, что некоторые советы автора очень даже можно использовать при работе над своими текстами.

Это книга о том, как писать статьи о людях, путешествиях, спорте, технике, об искусстве и о себе. Автор подробно рассказывает, как написать нехудожественный текст на заданную тему. Описывая методику работы над текстом, он приводит много ярких примеров. Несмотря на то, что они взяты из газет и журналов, опубликованных в США с 1960-х по 1990-е годы, примеры доходчивы и понятны.

 

книга о том, как писать нехудожественные тексты

 

Основные идеи книги я бы сформулировал так:

  1. Писать только о том, что знаешь очень хорошо*: приступая к работе, готовиться и собирать материалы.
  2. Работать над текстом: сокращать, упрощать и вычищать все лишнее.
  3. Хороший текст должен звучать: чтение текста вслух как контроль качества.

Некоторые рекомендации Уильяма Зинсера перекликаются с требованиями к стилю изложения пользовательской документации:

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

Книга особенно подойдет тем, кто пишет статьи для блогов и научно-популярные статьи. Вот несколько советов:

 

"Выбирая слова и связывая их вместе, следите за тем, как они звучат. Это может показаться нелепым: ведь читатели читают глазами. Но на самом деле они слышат то, что читают, в гораздо большей степени, чем вы себе представляете" (Зинсер 2016: 46).

 

"Если ваши фразы тянутся одна за другой так вяло, что это нагоняет уныние даже на вас самих, прочтите их вслух (я всегда ориентируюсь на звучание и непременно прочитываю вслух все, что написал, прежде чем отправить заказчику). Тогда вы поймете, что с ними неладно" (Зинсер 2016: 47).

 

"…если вы хотите добиться успеха, ваши заметки на страницах газеты или журнала должны бросаться в глаза, приковывая к себе внимание раньше всех остальных. Ваша задача — найти способ поднять свои сочинения до уровня развлекательных. Обычно для этого бывает достаточно угостить читателя каким-нибудь приятным сюрпризом. Конкретных приемов здесь множество: шутка, анекдот, парадокс, неожиданная цитата, впечатляющий факт, диковинная подробность, окольный подход к теме, элегантное сочетание слов" (Зинсер 2016: 281).

 

* …писать должно либо о том, что ты знаешь очень хорошо, либо о том, что не знает никто.
А. и Б. Стругацкие
 

 

 

 

Добавить комментарий

Комментарии  

Sheldon
# 0 Sheldon 21.08.2020 06:14
I enjoy reading an article that where
can you buy viagra: https://judpharmacy.com/ make people think. Also, many thanks for permitting me to comment!
Ответить Ответить с цитатой Цитировать

Последние статьи

Что нового в Help+Manual 8

10 февраля 2020 года вышла 8-я версия Help+Manual. Любой желающий может бесплатно скачать пробную версию с сайта компании-разработчика и оценить ее потенциал. В течени...

Читать полностью...

Работа со стилями в Help and Manual 7

Чтобы внешний вид нового CHM-файла соответствовал оригиналу, необходимо создать стили, применить их к проекту и очистить встроенное форматирование. Это позволит обеспе...

Читать полностью...

Форматы справки для ОС Linux

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

Читать полностью...

Сборка CHM-файла в Help and Manual

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

Читать полностью...

Основные настройки проекта в Help and Ma…

Если для сборки справки не используется шаблон (skin-file), внешний вид и основной функционал CHM-справки берется из настроек проекта. В этой статье я расскажу о том, ...

Читать полностью...

Импорт CHM в Help and Manual

Программный комплекс Help and Manual позволяет импортировать документацию из ряда форматов, в том числе, из HTML и CHM. Готовую документацию можно загрузить как в суще...

Читать полностью...

Как отредактировать CHM в Help and Manua…

Если вам нужно внести несколько небольших правок в CHM-файл, такую задачу можно успешно решить при помощи бесплатных программ HTML Help Workshop и Notepad++. Серьезная...

Читать полностью...

Как сделать качественные скриншоты

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

Читать полностью...

Внесение изменений и сборка нового CHM-ф…

Перед тем, как приступить непосредственно к редактированию содержимого CHM-файла, подытожим выполненные заранее подготовительные работы. Определившись с бесплатными пр...

Читать полностью...

Создание и настройка проекта в HTML Help…

Установив необходимые бесплатные программы, мы разобрали исходный файл api.chm и получили 64 файла (подробнее смотрите материал Декомпиляция CHM-файла). Это основная ч...

Читать полностью...

Декомпиляция CHM-файла

Файл в формате CHM представляет собой скомпилированный HTML. В него могут входить HTML-страницы, рисунки, таблицы стилей, скрипты и другие файлы. Подробное описание со...

Читать полностью...

Редактирование CHM бесплатными программа…

Если заказчику или работодателю не принципиально, какое программное обеспечение использовать, я предпочитаю редактировать CHM в Help+Manual 7. Но как показывает практи...

Читать полностью...

Как отредактировать CHM-файл

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

Читать полностью...

Как создать справку в формате CHM

Формат HTML Help или CHM был разработан компанией Microsoft в 1997 г. Сегодня CHM остается стандартом справки для приложений, работающих в ОС Windows. Средство для про...

Читать полностью...

Бесплатный локальный сервер HM2GO для We…

Одна из моих предыдущих статей была посвящена особенностям работы WebHelp на локальных компьютерах. Некоторые популярные браузеры, в том числе Google Chrome, Opera и Я...

Читать полностью...

Дата в полном формате с месяцем в родите…

Сегодня пользовательская документация поставляется, как правило, в электронном формате и содержит дату выпуска. Ее обычно указывают в хедере, футере или в специальном ...

Читать полностью...

Все о справке и документации для пользователей!

Следить за новыми статьями:

© Илья Жуков, 2019. Охраняется законом об авторском праве.