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

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

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

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

 

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

 

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

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

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

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

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

 

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

 

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

 

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

 

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

 

 

 

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

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

Подключение таблицы стилей к проекту Hel…

При работе с форматами, основанными на HTML, для оформления контента в документах можно использовать каскадные таблицы стилей, cascading style sheets или CSS. Данная т...

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

Формулы в HTML Help (CHM)

Я по образованию филолог. Специализируюсь на разработке пользовательской документации на английском и русском языках. С формулами в документации сталкиваюсь редко и по...

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

Импорт документов MS Word в Help+Manual…

Часто технический писатель получает исходные данные от аналитиков, разработчиков, тестировщиков, маркетологов и других специалистов в форматах DOC, DOCX и RTF (реже, и...

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

Поиск в WebHelp находит удаленные раздел…

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

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

Контекстная справка в приложениях Window…

Понятие контекстной или контекстно-зависимой справки (от англ. context-sensitive help) появилось в 1987 году с выходом формата WinHelp. Изначально контекстная справка ...

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

Как поддерживать скриншоты в актуальном …

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

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

Книга «Разработка технической документац…

Уважаемые коллеги! Если вам нужно быстро освоить разработку документации по ГОСТ, рекомендую обратить внимание на книгу В.А. Глаголева «Разработка технической документ...

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

Перевод выходных документов в Help and M…

Выбрав русский язык и русскую кодировку в настройках проекта Help and Manual, многие авторы после первой сборки удивляются, увидев в выходных документах английские сло...

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

Размер и расположение окна CHM при перво…

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

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

Рваные края скриншотов в Help and Manual…

Многие платные редакторы скриншотов, например, SnagIt, FastStone Capture и др., умеют создавать эффект рваных краев. В сети Интернет можно найти множество видеоуроков ...

Читать полностью...
новое в Help and Manual 9

Новое в Help and Manual 9

23 ноября 2022 года компания EC Software к 25-летнему юбилею выпустила 9-ю версию программного комплекса Help and Manual (выходит c 1997 года). Комплект шаблонов Premi...

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

Создание CHM-справки в бесплатной програ…

KEL CHM Creator — это «новая» хорошо забытая программа, выпущенная в 2012 году, предназначенная для создания и декомпиляции CHM-файлов. Программа не требовательна к ре...

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

KEL CHM Creator — бесплатная программа д…

Если вам нужно создать CHM-файл, и вы больше не хотите пользоваться глючной программой HTML Help Workshop, тогда KEL CHM Creator — это ваш вариант. Программа позволяет...

Читать полностью...
ключевые слова

Ключевые слова в Help+Manual…

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

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

HTML Help Workshop – бесплатная программ…

В 1997 году Microsoft выпустила новый формат справки, HTML Help (CHM), а также бесплатную программу для создания и редактирования справки в этом формате — HTML Help Wo...

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

HelpNDoc — бесплатная альтернатива Help+…

Еще одной альтернативой RoboHelp и Help&Manual является программа HelpNDoc от французского разработчика, компании IBE Software. Это практически полный аналог HelpS...

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

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

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

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