Download as pdf or txt
Download as pdf or txt
You are on page 1of 49

Download and Read online, DOWNLOAD EBOOK, [PDF EBOOK EPUB ], Ebooks

download, Read Ebook EPUB/KINDE, Download Book Format PDF

Writing and Designing Manuals and Warnings 5th


Edition Patricia A Robinson

OR CLICK LINK
https://textbookfull.com/product/writing-and-
designing-manuals-and-warnings-5th-edition-
patricia-a-robinson/

Read with Our Free App Audiobook Free Format PFD EBook, Ebooks dowload PDF
with Andible trial, Real book, online, KINDLE , Download[PDF] and Read and Read
Read book Format PDF Ebook, Dowload online, Read book Format PDF Ebook,
[PDF] and Real ONLINE Dowload [PDF] and Real ONLINE
More products digital (pdf, epub, mobi) instant
download maybe you interests ...

Writing and Designing Manuals and Warnings Fifth


Edition Patricia A. Robinson (Author)

https://textbookfull.com/product/writing-and-designing-manuals-
and-warnings-fifth-edition-patricia-a-robinson-author/

Behavioral Consultation and Primary Care: A Guide to


Integrating Services 2nd Edition Patricia J. Robinson

https://textbookfull.com/product/behavioral-consultation-and-
primary-care-a-guide-to-integrating-services-2nd-edition-
patricia-j-robinson/

A Scientific Turn in the Genre of How to Fiction


Writing Manuals 4th Edition Veleski

https://textbookfull.com/product/a-scientific-turn-in-the-genre-
of-how-to-fiction-writing-manuals-4th-edition-veleski/

Basics of Behavior Change in Primary Care Patricia J.


Robinson

https://textbookfull.com/product/basics-of-behavior-change-in-
primary-care-patricia-j-robinson/
A Student Handbook for Writing in Biology 5th Edition
Karin Knisely

https://textbookfull.com/product/a-student-handbook-for-writing-
in-biology-5th-edition-karin-knisely/

Becoming an Academic Writer 50 Exercises for Paced


Productive and Powerful Writing Patricia Goodson

https://textbookfull.com/product/becoming-an-academic-
writer-50-exercises-for-paced-productive-and-powerful-writing-
patricia-goodson/

Writing Manuals For The Masses: The Rise Of The


Literary Advice Industry From Quill To Keyboard
Anneleen Masschelein

https://textbookfull.com/product/writing-manuals-for-the-masses-
the-rise-of-the-literary-advice-industry-from-quill-to-keyboard-
anneleen-masschelein/

Ocean Science and the British Cold War State Samuel A.


Robinson

https://textbookfull.com/product/ocean-science-and-the-british-
cold-war-state-samuel-a-robinson/

Farm Management Patricia A. Duffy

https://textbookfull.com/product/farm-management-patricia-a-
duffy/
Writing and Designing
Manuals and Warnings
Writing and Designing
Manuals and Warnings
Fifth Edition

Patricia A. Robinson
CRC Press
Taylor & Francis Group
6000 Broken Sound Parkway NW, Suite 300
Boca Raton, FL 33487–2742
© 2020 by Taylor & Francis Group, LLC
CRC Press is an imprint of Taylor & Francis Group, an Informa business
No claim to original U.S. Government works
Printed on acid-free paper
International Standard Book Number-13 978-0-367-11109-0 (Hardback)
This book contains information obtained from authentic and highly regarded sources. Reasonable
efforts have been made to publish reliable data and information, but the author and publisher
cannot assume responsibility for the validity of all materials or the consequences of their use. The
authors and publishers have attempted to trace the copyright holders of all material reproduced in
this publication and apologize to copyright holders if permission to publish in this form has not
been obtained. If any copyright material has not been acknowledged, please write and let us know
so we may rectify in any future reprint.
Except as permitted under U.S. Copyright Law, no part of this book may be reprinted, reproduced,
transmitted, or utilized in any form by any electronic, mechanical, or other means, now known or
hereafter invented, including photocopying, microfilming, and recording, or in any information
storage or retrieval system, without written permission from the publishers.
For permission to photocopy or use material electronically from this work, please access www.
copyright.com (www.copyright.com/) or contact the Copyright Clearance Center, Inc. (CCC), 222
Rosewood Drive, Danvers, MA 01923, 978-750-8400. CCC is a not-for-profit organization that
provides licenses and registration for a variety of users. For organizations that have been granted a
photocopy license by the CCC, a separate system of payment has been arranged.
Trademark Notice: Product or corporate names may be trademarks or registered trademarks, and
are used only for identification and explanation without intent to infringe.

Library of Congress Cataloging‑in‑Publication Data


Names: Robinson, Patricia A., 1948– author.
Title: Writing and designing manuals and warnings / authored by
Patricia A. Robinson.
Description: Fifth edition. | Boca Raton : CRC Press, 2020. | Includes
bibliographical references and index.
Identifiers: LCCN 2019036123 (print) | LCCN 2019036124 (ebook) |
ISBN 9780367111090 (hardback) | ISBN 9780429025372 (ebook)
Subjects: LCSH: Technical writing.
Classification: LCC T11 .R635 2020 (print) | LCC T11 (ebook) | DDC
808.06/66—dc23
LC record available at https://lccn.loc.gov/2019036123
LC ebook record available at https://lccn.loc.gov/2019036124

Visit the Taylor & Francis Web site at


www.taylorandfrancis.com
and the CRC Press Web site at
www.crcpress.com
Dedication

This book is dedicated to all my


students, in classrooms and seminars,
in formal and informal settings. I’ve
learned more from you than I can say.
Contents
Preface to the Fifth Edition������������������������������������������������������������������������������������xvii
Acknowledgments���������������������������������������������������������������������������������������������������xix
Author���������������������������������������������������������������������������������������������������������������������xxi

PART I Product Safety in the 21st Century

Chapter 1 The Changing Landscape��������������������������������������������������������������������� 3


Overview����������������������������������������������������������������������������������������������3
Why Do We Still Need Manuals?��������������������������������������������������������3
The Customer�����������������������������������������������������������������������������4
First-Time Operation������������������������������������������������������������������4
Ongoing Reference���������������������������������������������������������������������5
Product Safety Resource������������������������������������������������������������5
The Company��������������������������������������������������������������������������������������� 6
Required Documentation����������������������������������������������������������� 6
Product Development Resource������������������������������������������������� 7
Marketing and Public Relations Document������������������������������� 8
What’s Changed?����������������������������������������������������������������������������������9
Higher Expectations������������������������������������������������������������������� 9
Safer Products���������������������������������������������������������������������������� 9
Better Instructions and Warnings�������������������������������������������� 10
Information on Demand����������������������������������������������������������� 11
Definition of Product�������������������������������������������������������������������������� 11
“Hey, Alexa!” Technology Permeates Everything����������������������������� 12
Alternatives to Reality������������������������������������������������������������� 12
The Internet of Things������������������������������������������������������������� 12
The Global Village����������������������������������������������������������������������������� 13
Expanded User Groups������������������������������������������������������������ 14
Bridging Communication Challenges�������������������������������������� 15
Proliferating Standards and Laws������������������������������������������������������ 18
European Union Requirements������������������������������������������������ 18
International Standards������������������������������������������������������������20
Law and Regulation����������������������������������������������������������������� 21
Summary�������������������������������������������������������������������������������������������� 22
Notes��������������������������������������������������������������������������������������������������� 23

Chapter 2 Know Your User and Your Product’s Hazards�����������������������������������25


Overview��������������������������������������������������������������������������������������������25
Keep the User Safe!����������������������������������������������������������������������������25

vii
viiiContents

Is My Product Reasonably Safe?���������������������������������������������25


Risk vs. Utility���������������������������������������������������������������26
Available Alternatives���������������������������������������������������26
Consumer Expectations�������������������������������������������������26
What Is “Reasonably Safe” Depends on Who’s
Using the Product����������������������������������������������������������������26
Who Are the Users (And Will They Read What I Write?)���������������� 27
Why Do I Need to Find Out about My Audience?������������������28
Sources of User Information���������������������������������������������������� 29
Sales Records����������������������������������������������������������������� 29
Sales and Service Personnel������������������������������������������ 30
Marketing Reports��������������������������������������������������������� 31
Product Development Reports��������������������������������������� 31
Trade Journals��������������������������������������������������������������� 31
Other Sources���������������������������������������������������������������� 32
Who Are These People?����������������������������������������������������������� 32
Age��������������������������������������������������������������������������������� 32
Gender���������������������������������������������������������������������������34
Culture and Geography������������������������������������������������� 35
Literacy and Language�������������������������������������������������� 37
Are Your Users Sophisticated?������������������������������������������������ 38
What Are the Hazards and What Should We Do about Them?��������� 39
What Is a Hazard Analysis?����������������������������������������������������� 39
Why Do a Hazard Analysis—And When Should We
Do It?�����������������������������������������������������������������������������������40
New Product Development��������������������������������������������40
Existing Products����������������������������������������������������������� 41
Model Changes�������������������������������������������������������������� 41
Throughout the Life Cycle of the Product��������������������� 41
How to Conduct a Hazard Analysis����������������������������������������� 42
Make It Systematic and Comprehensive����������������������� 42
What Method Is Best?��������������������������������������������������� 43
Are There Regulations and Standards That
Apply to Hazard Analysis?��������������������������������������� 45
Shouldn’t the Engineers Be Doing All This?���������������������������46
Why You Need a Cross-Disciplinary Team������������������46
“Shop-Blindness” Can Be Costly����������������������������������46
The “Person on the Street” May Be Your New
Best Friend���������������������������������������������������������������� 47
We Found a Hazard. What Now?�������������������������������������������� 47
Assess Severity and Likelihood������������������������������������ 47
Apply the Hazard Control Hierarchy���������������������������� 49
Apply a Rational, Standardized Mitigation
Process���������������������������������������������������������������������� 51
Document, Document, Document!�������������������������������� 52
Summary�������������������������������������������������������������������������������������������� 53
Contents ix

Checklist: Users and Hazards������������������������������������������������������������ 53


Notes��������������������������������������������������������������������������������������������������� 54

PART II The Making of a Manual


(Or More Than One!)

Chapter 3 Designing a User-Friendly Manual���������������������������������������������������� 59


Overview�������������������������������������������������������������������������������������������� 59
What Do Users Want?������������������������������������������������������������������������ 59
When All Else Fails . . .����������������������������������������������������������� 59
They’re Boring��������������������������������������������������������������� 59
They’re Hard to Read����������������������������������������������������60
They’re Confusing���������������������������������������������������������60
They Don’t Answer My Questions�������������������������������� 61
The Unwritten Goal of a Successful Manual��������������������������� 61
Creeping Featurism������������������������������������������������������� 62
Cognitive Friction���������������������������������������������������������� 62
Productivity Paradox����������������������������������������������������� 62
How Do People Use Manuals?����������������������������������������������������������� 62
How Do I . . . ?������������������������������������������������������������������������� 63
What’s This Thing For?����������������������������������������������������������� 63
All I Want to Know Is . . .��������������������������������������������������������64
I Don’t Have All Day��������������������������������������������������������������� 65
My Inbox Runneth Over���������������������������������������������������������� 65
You Can’t Put a Tractor on a Desk�������������������������������������������66
Manual? What Manual? Keeping Product and Manual
Together������������������������������������������������������������������������������� 67
Choosing Content������������������������������������������������������������������������������� 68
User Questions as Manual Organizers������������������������������������ 68
You Can Say That Again: Useful Redundancy������������������������ 69
How to Use the Product Is Not the Same as How
It Works������������������������������������������������������������������������������� 70
Focus on the Need-to-Know���������������������������������������������������� 70
Organizing Content: Cookbooks, Not Novels������������������������������������ 71
I Want to Make an Apple Pie—Why Must I Read
about Beef Stew?����������������������������������������������������������������� 71
Mix and Match: Using Modular Organization������������������������ 73
Designing for the Two-Page Spread���������������������������������������� 75
Make the Language Accessible���������������������������������������������������������� 76
Language Level and Readability Indices��������������������������������� 76
Who Are Your Users? Are You Sure?������������������������������������� 76
Jargon, Slang, and Technical Language����������������������������������� 77
The Importance of Consistency����������������������������������������������� 78
xContents

Writing Strategies That Work������������������������������������������������������������ 79


Dividing and Sequencing Information������������������������������������ 79
Spatial���������������������������������������������������������������������������� 81
Chronological���������������������������������������������������������������� 81
Presenting Information������������������������������������������������������������ 81
Big Picture First������������������������������������������������������������� 85
Parallel Patterns������������������������������������������������������������� 86
The Power of the List���������������������������������������������������� 91
Linking Information����������������������������������������������������������������92
Sharpening the Focus���������������������������������������������������� 93
Smoothing the Transition����������������������������������������������94
Summary��������������������������������������������������������������������������������������������96
Checklist: The User-Friendly Manual������������������������������������������������96
Notes���������������������������������������������������������������������������������������������������97

Chapter 4 What You See Is What You Read. . . . Or Not�����������������������������������99


Overview��������������������������������������������������������������������������������������������99
Make the Manual Look Easy to Read���������������������������������������������� 100
Principles of Page Design������������������������������������������������������ 100
Making a Good First Impression������������������������������������������� 101
Why Less Is More—Strategies for Reducing Text���������������� 104
Concision��������������������������������������������������������������������� 105
Alternatives to Text����������������������������������������������������� 106
White Space Is Not Empty���������������������������������������������������� 106
Where Are My Reading Glasses?������������������������������������������ 107
Font Size: What’s the Point?���������������������������������������� 107
Font Style: A Continuing Debate�������������������������������� 108
The Case for Readability������������������������������������������������������� 109
How Many Columns Should I Use?��������������������������������������� 109
Headings: A Map for Your Reader��������������������������������������������������� 114
What Comes Next? Signaling Sequence�������������������������������� 114
Signaling Hierarchy: Putting the Pieces Together.................. 115
Making It Work���������������������������������������������������������������������� 116
Other Signposts for Your Reader����������������������������������������������������� 118
Headers and Footers�������������������������������������������������������������� 118
Numbering Systems��������������������������������������������������������������� 118
Physical Organizers��������������������������������������������������������������� 119
Paving the Road for Your Readers��������������������������������������������������� 119
Writing From the User’s Point of View��������������������������������� 120
Unfamiliar Terms�������������������������������������������������������� 120
Jargon or In-House Terms������������������������������������������� 120
Inconsistent Terms������������������������������������������������������� 121
Writing Correctly������������������������������������������������������������������� 121
Writing Precisely: Getting Rid of Weasel Words������������������ 123
Making the Manual Physically Easy to Use������������������������������������ 124
Size����������������������������������������������������������������������������������������� 124
Paper�������������������������������������������������������������������������������������� 125
Contents xi

Binding����������������������������������������������������������������������������������� 125
Cover�������������������������������������������������������������������������������������� 126
Summary������������������������������������������������������������������������������������������ 126
Checklist: Make It Easy for Your Readers��������������������������������������� 127
Notes������������������������������������������������������������������������������������������������� 127

Chapter 5 A Picture Is Worth . . . It Depends��������������������������������������������������� 129


Overview������������������������������������������������������������������������������������������ 129
When to Use Graphics��������������������������������������������������������������������� 130
Is There a Picture in Your Mind?������������������������������������������ 130
Identifying Parts���������������������������������������������������������� 130
Explaining Spatial Relationships��������������������������������� 132
Do You Have a Lot of Numbers to Convey?�������������������������� 133
Explaining Procedures: Show and Tell���������������������������������� 133
Will the Manual Be Translated?�������������������������������������������� 133
What Kind of Graphics Should I Use?��������������������������������������������� 134
Photographs��������������������������������������������������������������������������� 134
Drawings�������������������������������������������������������������������������������� 136
Tables������������������������������������������������������������������������������������� 139
Charts and Graphs����������������������������������������������������������������� 141
Making Graphics Work�������������������������������������������������������������������� 144
Size Matters: Make Them Big Enough to See����������������������� 145
Less Is (Still) More���������������������������������������������������������������� 146
What Am I Looking At? Making Graphics Clear����������������� 146
Integrating Graphics and Text���������������������������������������������������������� 149
Begin at the Beginning: Storyboards and Outlines��������������� 150
What Are My Graphics For?������������������������������������������������� 150
Graphics That Complement Text��������������������������������� 150
Graphics That Supplement Text���������������������������������� 152
Graphics That Substitute for Text�������������������������������� 153
Laying Out the Pages������������������������������������������������������������� 155
Summary������������������������������������������������������������������������������������������ 156
Checklist: Effective Graphic Design������������������������������������������������ 157
Notes������������������������������������������������������������������������������������������������� 157

Chapter 6 Thinking Outside the Books������������������������������������������������������������ 159


Overview������������������������������������������������������������������������������������������ 159
Putting It on the Internet������������������������������������������������������������������ 159
The Digital Revolution: Beyond Paper���������������������������������� 159
Information on Demand��������������������������������������������������������� 160
Technical Assistance: A Mouse-Click Away������������������������� 160
Penny-Wise and Pound-Foolish����������������������������������� 161
Will Users Pay?����������������������������������������������������������� 161
Integrated Product Documentation: Are Paper
Manuals Today’s Buggy Whips?��������������������������������������� 161
Should We Put All Our Manuals on the Internet?����������������� 162
xiiContents

Instructional Videos and Website Animations��������������������������������� 163


What Makes a Video Work?�������������������������������������������������� 164
Type of Product����������������������������������������������������������� 164
Technical Quality�������������������������������������������������������� 165
Planning and Scripting������������������������������������������������ 165
Planning an Instructional Video�������������������������������������������� 166
Controlling the Pace���������������������������������������������������� 166
Allowing for Updates�������������������������������������������������� 167
Video as an Ongoing Reference��������������������������������������������� 168
Safety Information in Videos�������������������������������������� 168
You Can Find Anything on YouTube�������������������������� 169
Website Animations��������������������������������������������������������������� 169
Picture This: The No-Words Manual����������������������������������������������� 170
Pictures Are Abstractions Too����������������������������������������������� 170
Know Your User�������������������������������������������������������������������� 171
Planning the Pictorial Manual����������������������������������������������� 171
How Do You Know If You’ve Succeeded?�������������������������������������� 172
Usability Testing Methods����������������������������������������������������� 172
Informal and In-House������������������������������������������������ 173
Beta-Site Testing���������������������������������������������������������� 173
Formal Systematic Analysis���������������������������������������� 173
Other Alternatives������������������������������������������������������� 173
Usability Testing for Visual Manuals������������������������������������ 174
Summary������������������������������������������������������������������������������������������ 174
Checklist: Alternatives and Specialty Manuals������������������������������� 175
Notes������������������������������������������������������������������������������������������������� 175

Chapter 7 Special-Purpose Manuals����������������������������������������������������������������� 177


Is One Enough? When You Need Multiple Manuals����������������������� 177
When Just One Won’t Do������������������������������������������������������� 177
What’s the Downside?������������������������������������������������������������ 178
Installation, Service, and Maintenance Manuals����������������������������� 179
Who Are Your Readers?�������������������������������������������������������� 179
What Goes Into a Special-Purpose Manual?������������������������� 180
Installation Manuals���������������������������������������������������� 180
Service and Maintenance Manuals����������������������������� 181
Style Differences�������������������������������������������������������������������� 182
Level of Detail������������������������������������������������������������� 182
Language Level����������������������������������������������������������� 184
Pace������������������������������������������������������������������������������ 186
Tone����������������������������������������������������������������������������� 186
Design Differences���������������������������������������������������������������� 187
Organization���������������������������������������������������������������� 187
Page Size and Layout��������������������������������������������������� 188
Binding System������������������������������������������������������������ 188
Graphics����������������������������������������������������������������������� 188
Contents xiii

Keeping Service and Maintenance Manuals


Current������������������������������������������������������������������������������ 191
Manuals as Training Texts����������������������������������������������������� 192
Manuals for Custom Machinery������������������������������������������������������ 193
The One-Time Manual����������������������������������������������������������� 193
Managing Manuals for Component Parts������������������������������ 194
Summary������������������������������������������������������������������������������������������ 194
Checklist: Special-Purpose Manuals����������������������������������������������� 195

PART III You Have Been Warned

Chapter 8 The Duty to Warn����������������������������������������������������������������������������� 199


Overview������������������������������������������������������������������������������������������ 199
Products Liability Law: What You Don’t Know Can
Hurt You�������������������������������������������������������������������������������������� 199
When Is the Seller Liable?�����������������������������������������������������200
Legal Theories����������������������������������������������������������������������� 201
Breach of Warranty����������������������������������������������������� 201
Negligence������������������������������������������������������������������� 201
Strict Liability in Tort�������������������������������������������������� 201
It’s Not Fair—Or Is It?�����������������������������������������������������������202
Geographical Variations—United States and
Abroad�������������������������������������������������������������������������������202
Failure to Warn in Products Liability Litigation������������������������������ 203
Safer Designs�������������������������������������������������������������������������204
More Automation�������������������������������������������������������������������204
Expectation of Safety (Or, If I Get Hurt, It Must Be
Somebody’s Fault)�������������������������������������������������������������205
Perceived Ease of Warning����������������������������������������������������205
Warnings—They’re Not All Wacky (But Some Sure Are!)�������������206
When Do You Need a Warning?�������������������������������������������206
Open and Obvious�������������������������������������������������������206
Foreseeable Misuse�����������������������������������������������������207
Who Needs to Be Warned?����������������������������������������������������208
Can You Have Too Many Warnings?������������������������������������� 210
Keep the User Safe: Comprehensive Safety Information����������������� 211
On-Product Safety Labels������������������������������������������������������ 211
Signal Word����������������������������������������������������������������� 211
Safety-Alert Symbol���������������������������������������������������� 212
Signal-Word Panel������������������������������������������������������� 212
Safety Messages in Manuals and Packaging������������������������� 212
Coordinating Manual and Labels������������������������������������������ 213
If There’s a Label on the Product, Put One in
the Manual�������������������������������������������������������������� 213
xivContents

Separate General Safety Warnings From Those


Specific to the Product�������������������������������������������� 214
Use the Label to Refer the User to the Manual����������� 214
Other Avenues for Safety Messages��������������������������������������� 215
Managing the Post-Sale Duty to Warn��������������������������������������������� 215
Does Improved Safety Mean Earlier Models Are
Defective?�������������������������������������������������������������������������� 216
Should I Recall or Retrofit?��������������������������������������������������� 216
How Can I Find Product Users?�������������������������������������������� 217
What Kind of Safety Upgrades Should I Offer?�������������������� 217
Summary������������������������������������������������������������������������������������������ 218
Checklist: Managing Product Safety����������������������������������������������� 219
Notes������������������������������������������������������������������������������������������������� 219

Chapter 9 Warnings That Work������������������������������������������������������������������������ 221


Overview������������������������������������������������������������������������������������������ 221
What Should a Warning Do?������������������������������������������������������������ 221
What Makes a Warning Adequate?��������������������������������������� 221
Identify the Nature and Severity of the Hazard���������� 222
Tell How to Avoid the Hazard�������������������������������������224
Explain the Consequences of Not Avoiding the
Hazard���������������������������������������������������������������������224
Clearly Communicate to the User�������������������������������224
Focus on Safety Instead of Liability�������������������������������������� 225
Who Should Write the Warnings?����������������������������������������� 227
Meeting Standards . . . Which Ones?����������������������������������������������� 229
Government Regulations������������������������������������������������������� 229
The Federal Hazardous Substances Act���������������������� 229
The OSHA Hazard Communication Standard������������ 230
Consumer Product Safety Act������������������������������������� 233
Voluntary Standards�������������������������������������������������������������� 234
The Anatomy of a Warning�������������������������������������������������������������� 235
ANSI Z535.4�������������������������������������������������������������������������� 235
Safety-Alert Symbol���������������������������������������������������� 235
Signal Word����������������������������������������������������������������� 235
Color���������������������������������������������������������������������������� 237
Pictorial����������������������������������������������������������������������� 237
Word Message������������������������������������������������������������� 241
ISO 3864–2���������������������������������������������������������������������������� 243
Harmonization of ANSI Z535.4 and ISO 3864–2�����������������244
ANSI Z535.6�������������������������������������������������������������������������� 245
What ANSI Z535.6 Covers������������������������������������������ 245
Categories of Safety Information�������������������������������� 245
How ANSI Z535.6 Can Help You�������������������������������246
Other Considerations for On-Product Labels����������������������������������� 247
Contents xv

Durability������������������������������������������������������������������������������� 247
Size and Placement���������������������������������������������������������������� 249
Testing Your Warnings��������������������������������������������������������������������� 251
Why Test Warnings?�������������������������������������������������������������� 251
Designing an Effective Test��������������������������������������������������� 251
Validity������������������������������������������������������������������������ 251
Reliability�������������������������������������������������������������������� 252
Elements of a Test������������������������������������������������������������������ 252
Choosing Your Subjects���������������������������������������������� 252
Designing the Test������������������������������������������������������� 254
Administering the Test������������������������������������������������ 254
Scoring the Test—How Good Is Good Enough?��������� 255
Summary������������������������������������������������������������������������������������������ 256
Checklist: Make Your Warnings Work�������������������������������������������� 257
Notes������������������������������������������������������������������������������������������������� 258

PART IV Making It Work in the Real World

Chapter 10 Who Writes a Manual?��������������������������������������������������������������������� 263


Overview������������������������������������������������������������������������������������������ 263
Technical Writers—Low on the Food Chain No More������������������� 263
The Voice of the Company����������������������������������������������������264
Training for Writers�����������������������������������������������������264
Other Helps for Writers����������������������������������������������� 265
Which Is Better—Engineer or English Major?����������� 265
When I Grow Up, I Want to Be . . . a Technical
Writer?��������������������������������������������������������������������266
If We’re So Smart, Why Aren’t We Rich?����������������������������� 267
Writing Manuals Is a Team Sport���������������������������������������������������� 268
How Many Writers Does It Take to Make a Manual?����������� 268
The Solo Writer����������������������������������������������������������� 268
Team Writing��������������������������������������������������������������� 269
Working With Graphic Artists����������������������������������������������� 270
Take an Engineer to Lunch (or: Cultivate a Source)�������������� 271
Become Part of the Product Development Team�������� 273
Cultivate Contacts in Key Areas (and Do a
Few Favors)������������������������������������������������������������� 273
Use Modular Design���������������������������������������������������� 273
Playing Well with Others: Marketing, Legal, Design,
Manufacturing����������������������������������������������������������������������������� 273
Location, Location, Location: Where Do You Put
Tech Pubs?������������������������������������������������������������������������� 275
Different Roles Mean Different Agendas������������������������������ 275
xviContents

Consensus Building and Turf Wars��������������������������������������� 276


How Well Can You Juggle? Managing Documentation
Projects���������������������������������������������������������������������������������������� 276
Writers Need Only Two Things��������������������������������������������� 277
Scheduling Document Production����������������������������������������� 277
What Do You Need to Produce?���������������������������������� 278
How Much Time Do You Have?���������������������������������� 278
What Personnel Can You Assign?������������������������������� 279
Monitoring an Ongoing Project��������������������������������������������� 279
Benchmarks�����������������������������������������������������������������280
Project Logs�����������������������������������������������������������������280
Overcoming Organizational Obstacles���������������������������������� 281
Company Size�������������������������������������������������������������� 281
Understanding Internal Dynamics������������������������������ 282
How to Sell Your Boss on High-Quality Documentation����� 283
Technical Assistance and Service Costs���������������������284
Products Liability Costs���������������������������������������������� 285
Summary������������������������������������������������������������������������������������������ 286
Checklist: Writers and Documentation Projects������������������������������ 286
Notes������������������������������������������������������������������������������������������������� 287

Chapter 11 Integrated Product Safety: The Manual Is Just the Beginning�������� 289
Overview������������������������������������������������������������������������������������������ 289
Designing Safety into the Product��������������������������������������������������� 289
Why You Need a Product Safety Team—And Who
Should Be on It������������������������������������������������������������������ 290
Multiple Perspectives��������������������������������������������������� 290
Cross-Functional Buy-In��������������������������������������������� 291
Enforcement Authority������������������������������������������������ 291
Concurrent Development: Better and Safer Products������������ 291
Delivering a Consistent Safety Message������������������������������������������ 293
Why the Model Wore Safety Glasses������������������������������������ 293
The Patent Medicine Show: When the Sales Rep
Promises the Moon����������������������������������������������������������� 295
Installation: The Customer Connection��������������������������������� 295
Service—And Safety—With a Smile������������������������������������ 296
Integrated Product Safety in the Real World: Case Study��������������� 296
Initial Information Gathering and Hazard Analysis�������������� 297
Drafting of Instructions and Warnings���������������������������������� 298
Refining the Drafts and Ensuring Consistency��������������������� 299
Summary������������������������������������������������������������������������������������������302
Checklist: Integrating Product Safety���������������������������������������������� 303
Notes������������������������������������������������������������������������������������������������� 303
Resources�������������������������������������������������������������������������������������������������������������� 305
Index����������������������������������������������������������������������������������������������������������������������307
Preface to the Fifth Edition
The world is different from how it looked even a decade ago, and the pace of change
just keeps accelerating. When the last edition of this book was written, the iPhone
had just been invented. Now smartphones are everywhere and doing things unimagi-
nable just a few years back. You can use your phone to track your escape-artist dog,
turn the heat up in your house as you commute home from the office, accept a digital
payment, and board a plane. And that’s just for starters. Technology is changing the
way we do business, the way we communicate with each other, and the way we learn.
More companies than ever are doing business internationally, but even domes-
tically, the U.S. population is increasingly diverse. About 20% of the population
speaks a language other than English at home, and that percentage is expected to
remain steady for at least the next decade. Providing product users with instructions
and safety information becomes even more of a challenge when customers span an
ever-widening wide spectrum of languages and cultural variation.
Since the last edition, products liability exposure has become even more of a
concern for manufacturers, and allegations of failure to warn have become a lead-
ing basis for lawsuits in the U.S. At the same time, while litigation is less prevalent
internationally than here at home, new international standards and country-specific
legislation have recognized the critical role played by instructions and warnings.
This book, like its predecessors, is intended to help those in the trenches—the
technical writers, graphic artists, engineers, and others who are charged with pro-
ducing product documentation. While the content is informed by current research,
it also reflects the real-world knowledge of hundreds of practitioners. Research can
guide us, but there is no substitute for experience when it comes to applying that
guidance when the realities of budgets and market-driven timelines make trade-offs
inevitable. Whether you are brand-new on the job or have labored for years, this
book will have something to help you.
Some things don’t change, but many do. This edition, while preserving the basic
guidelines for developing manuals and warnings presented in the previous edition,
offers new material as well, including an expanded section on hazard analysis. As
litigation involving warnings and instructions increases and products connect in
the Internet of Things, it becomes even more important to have a systematic way
to evaluate and respond to product hazards. And while virtually all products need
instructions and safety information, this information may not always be presented
in a paper manual. This edition explores into how emerging technology is changing
the world of documentation, from videos to virtual reality and all points in between.
As always, I hope you find it a helpful resource to navigate the challenges of prod-
uct documentation in the 21st century.

Patricia A. Robinson

xvii
Acknowledgments
Many individuals have contributed to this and previous editions of this book by shar-
ing their expertise and their materials—too many to list here. I thank you and so do
the readers of this book who will use your contributions to write better manuals and
develop more effective warnings. One of the book’s central motifs is to focus on keep-
ing the user safe. Because of the collective wisdom you have freely shared, be assured
that you have helped to do just that: you have prevented injuries and saved lives.
The materials for the book were collected in a number of ways. Some came from in-
house technical writing seminars for industry, visits to service publications operations,
teaching in national and regional conferences and workshops devoted to product safety
and technical writing, and serving as a private consultant. Individuals and organizations
who have worked with us and/or whose materials provided the subjects and examples
include Acme Burgess, Inc.; American Honda Motor Company; American Optical
Company; American Suzuki Motor Corporation; Atwood Mobile Products; Butler
Manufacturing Company; Briggs and Stratton Power Products Group, LLC; Chrysler
Motors Corporation; Clarion Safety Systems, Inc.; Clark Components International;
Construction Industry Manufacturers’ Association; CooperVision Surgical Systems;
Country Home Products, Inc.; CPM Acquisitions Corporation; Datamax Corporation;
Deere and Company; Delta International Machinery Corporation; Devilbiss Company;
Doboy Packaging Machinery; Dri-Eaz Products, Inc.; E.1. DuPont De Nemours and
Company; Electrolux Home Products; Epson America, Inc.; Farm Implement and
Equipment Institute; Fellowes Manufacturing Company; Fisher and Paykel Appliance,
Inc.; FMC Corporation; Ford Motor Company, Ford Tractor Division; Ford New
Holland; Fulton Manufacturing Corporation; Gardner Denver; Gehl Company; General
Electric Company and General Electric Medical Systems; General Motors Company;
Gerber Products Company; Harley Davidson Motor Company; Hazelton-Rattech
Inc.; Hewlett-Packard; Honeywell Inc.; Huffy Corporation; Ingersoll-Rand Company;
International Business Machines; International Harvester Company; International
Organization for Standardization; J. 1. Case Company; John Muir Publications;
Joy Manufacturing Company; Kartridg Pak Company; Kohler Corporation;
Krones Inc.; Mack Trucks-Mack International; Madison-Kipp Corporation; Mantis
Corporation; Martin Engineering; National Electrical Manufacturers Association;
Norden Laboratories; Ohio Medical Products; Outboard Marine Corporation; Pierce
Manufacturing Company; Pittsburgh Poison Center; Prairie Agricultural Machinery
Institute; Prairie Implement Manufacturers’ Association (and affiliated companies of
Canada); Rheem Manufacturing Company; Rosemount Inc.; Ryobi Outdoor Products,
Inc.; Scotsman; Siemens Medical System; Silver Reed America, Inc.; Simplicity
Manufacturing, Inc.; Sologear, LLC; Teresa Sprecher; Rosemary Stachel; Sunstrand
Aviation; TRW Ross Gear Division; Taylor Instrument Company; Technicare; Thern
Inc.; Versatile Corporation; Volkswagen of America; Wabco Construction and Mining
Equipment; Weber-Stephen Products Company; Westinghouse Electric Corporation;
World Kitchen, LLC.; and Yamaha Motor Company.
Finally, I owe a special thank you to my family and friends for putting up with me
through yet another edition of this book.
xix
Author
Patricia A. Robinson has been involved in technical writing for forty years. After
earning her PhD (in a different field) she joined the faculty of the University of
Wisconsin-Madison College of Engineering where she taught technical writing for
thirteen years. During her tenure at the University, the technical communication
program grew from a single report-writing course into a full certificate program.
She served as the first Director of that program. Dr. Robinson also served as pro-
gram director and primary instructor for continuing education seminars for practic-
ing technical writers and engineers, covering everything from Effective Speaking
to Managing the Technical Publications Department. An early invitation to teach
an in-plant course on operator manuals for a farm implement manufacturer led to
an unexpected—but greatly satisfying—career focus on instructions and warnings.
Dr. Robinson is the author of Fundamentals of Technical Writing and co-author
of Effective Writing Strategies for Engineers and Scientists. She has also published
articles in various professional journals and presented papers at professional confer-
ences. She is a regular speaker at product liability seminars on the role of instructions
and warnings. Dr. Robinson is a Full Member of the Human Factors and Ergonomics
Society, a member of IEEE, and a member of the ANSI Z535.6 subcommittee.
As owner of Coronado Consulting Services, LLC, Dr. Robinson consults widely
for industry both in the United States and internationally, and occasionally provides
expert testimony related to instructions and warnings. Dr. Robinson presently makes
her home in a small southern Arizona community, where horses and cattle consider-
ably outnumber humans. She can be reached at pat@coronadoconsulting.com.

xxi
Part I
Product Safety in
the 21st Century
Another random document with
no related content on Scribd:
With something vital in her, like those flowers
That on our desolate steppes outlast the year.
Resembles you in some things. It was that
First made us friends. I do her justice, see!
For we were friends in that smooth surface way
We Russians have imported out of France.
Alas! from what a blue and tranquil heaven
This bolt fell on me! After these two years,
My suit with Ossip Leminoff at end,
The old wrong righted, the estates restored,
And my promotion, with the ink not dry!
For those fairies which neglected me at birth
Seemed now to lavish all good gifts on me—
Gold roubles, office, sudden dearest friends.
The whole world smiled; then, as I stooped to taste
The sweetest cup, freak dashed it from my lips.
This very night—just think, this very night—
I planned to come and beg of you the alms
I dared not ask for in my poverty.
I thought me poor then. How stript am I now!
There’s not a ragged mendicant one meets
Along the Nevski Prospekt but has leave to tell his love,
And I have not that right!
Pauline Pavlovna, why do you stand there
Stark as a statue, with no word to say?

She. Because this thing has frozen up my heart.


I think that there is something killed in me,
A dream that would have mocked all other bliss.
What shall I say? What would you have me say?

He. If it be possible, the word of words!

She (very slowly). Well, then—I love you. I may tell you so
This once, ... and then forever hold my peace.
We cannot stay here longer unobserved.
No—do not touch me! but stand further off, and
Seem to laugh, as if we jested—eyes,
Eyes, everywhere! Now turn your face away....
I love you.

He. With such music in my ears I would death found me.


It were sweet to die listening! you love me—prove it.

She. Prove it—how? I prove it saying it. How else?

He. Pauline, I have three things to choose from; you shall choose.
This marriage, or Siberia, or France.
The first means hell; the second, purgatory;
The third—with you—were nothing less than heaven!

She (starting). How dared you even dream it!

He. I was mad. This business has touched me in the brain.


Have patience! the calamity’s so new.
(Pauses.) There is a fourth way, but the gate is shut
To brave men who hold life a thing of God.

She. Yourself spake there; the rest was not of you.

He. Oh, lift me to your level! So I’m safe.


What’s to be done?

She. There must be some path out. Perhaps the Emperor—

He. Not a ray of hope! His mind is set on this with that insistence
Which seems to seize on all match-making folk—
The fancy bites them, and they straight go mad.

She. Your father’s friend, the metropolitan—


A word from him....

He. Alas, he too is bitten!


Gray-haired, gray-hearted, worldly-wise, he sees
This marriage makes me the Tsar’s protégé
And opens every door to preference.
She. Think while I think. There surely is some key
Unlocks the labyrinth, could we but find it.
Nastasia!

He. What, beg life of her? Not I.

She. Beg love. She is a woman, young, perhaps


Untouched as yet of this too poisonous air.
Were she told all, would she not pity us?
For if she love you, as I think she must,
Would not some generous impulse stir in her,
Some latent, unsuspected spark illume?
How love thrills even commonest girl-clay,
Ennobling it an instant if no more!
You said that she is proud; then touch her pride,
And turn her into marble with the touch.
But yet the gentler passion is the stronger.
Go to her, tell her in some tenderest phrase
That will not hurt too much—ah, but ’twill hurt!
Just how your happiness lies in her hand
To make or mar for all time; hint, not say,
Your heart is gone from you, and you may find—

He. A casement in St. Peter and St. Paul


For, say, a month; then some Siberian town.
Not this way lies escape. At my first word
That sluggish Tartar blood would turn to fire
In every vein.

She. How blindly you read her,


Or any woman! Yes, I know, I grant
How small we often seem to our small world
Of trivial cares and narrow precedents—
Lacking that wide horizon stretched for men—
Capricious, spiteful, frightened at a mouse;
But when it comes to suffering mortal pangs,
The weakest of us measures pulse with you.
He. Yes, you, not she. If she were at your height!
But there’s no martyr wrapt in her rose flesh.
There should have been; for Nature gave you both
The self-same purple for your eyes and hair,
The self-same Southern music to your lips,
Fashioned you both, as ’twere, in the same mold,
Yet failed to put the soul in one of you!
I know her willful—her light head quite turned
In this court atmosphere of flatteries;
A Moscow beauty, petted and spoiled there,
And since, spoiled here; as soft as swan’s down, now,
With words like honey melting from the comb,
But being crossed, vindictive, cruel, cold.
I fancy her between two rosy smiles,
Saying, “Poor fellow, in the Nertchinsk mines!”

She. You know her not.


Count Sergius Pavlovich, you said no mask
Could hide the soul, yet how you have mistaken
The soul these two months—and the face to-night. (She removes
mask.)

He. You!—it was you.

She. Count Sergius Pavlovich, go find Pauline Pavlovna—she is


here—
And tell her that the Tsar has set you free. (Goes out hurriedly.)

GUNGA DIN
By Rudyard Kipling

You may talk o’ gin and beer


When you’re quartered safe out ’ere,
An’ you’re sent to penny-fights an’ Aldershot;
But when it comes to slaughter
You will do your work on water,
An’ you’ll lick the bloomin’ boots of ’im that’s got it.
Now in Injia’s sunny clime,
Where I used to spend my time
A-servin’ of ’Er Majesty the Queen,
Of all them blackfaced crew
The finest man I knew
Was our regimental bhisti, Gunga Din!
It was “Din! Din! Din!
You limping lump o’ brick-dust, Gunga Din!
Hi! slippery hitherao!
Water, get it! Pannee lao!
You squidgy-nosed old idol, Gunga Din.”

The uniform ’e wore


Was nothin’ much before,
An’ rather less than ’arf o’ that be’ind,
For a piece o’ twisty rag
An’ a goatskin water-bag
Was all the field equipment ’e could find.
When the sweatin’ troop-train lay
In a sidin’ through the day,
Where the ’eat would make your bloomin’ eyebrows crawl,
We shouted “Harry By!”
Till our throats were bricky-dry,
Then we wopped ’im cause ’e couldn’t serve us all.
It was “Din! Din! Din!
You ’eathen, where the mischief ’ave you been?
You put some juldee in it
Or I’ll marrow you this minute;
If you don’t fill up my helmet, Gunga Din!”

’E would dot an’ carry one


Till the longest day was done;
An’ ’e didn’t seem to know the use o’ fear.
If we charged or if we cut,
You could bet your bloomin’ nut,
’E’d be waitin’ fifty paces right flank rear.
With ’is mussick on ’is back,
’E would skip with our attack,
An’ watch us till the bugles made “Retire,”
An’ for all ’is dirty ’ide
’E was white, clear white, inside
When ’e went to tend the wounded under fire!
It was “Din! Din! Din!”
With the bullets kickin’ dust spots on the green,
When the cartridges ran out,
You could hear the front lines shout,
“Hi! ammunition-mules an’ Gunga Din!”

I sha’n’t forgit the night


When I dropped be’ind the fight
With a bullet where my belt-plate should ’a’ been.
I was chokin’ mad with thirst,
An’ the man that spied me first
Was our good old grinnin’, gruntin’ Gunga Din.
’E lifted up my head,
An’ ’e plugged me where I bled,
An’ ’e guv me ’arf-a-pint o’ water green:
It was crawlin’ and it stunk,
But of all the drinks I’ve drunk,
I’m gratefullest to one from Gunga Din.
It was “Din! Din! Din!
’Ere’s a beggar with a bullet through his spleen;
’E’s chawin’ up the ground,
An’ ’e’s kickin’ all around:
For Gawd’s sake git the water, Gunga Din!”

’E carried me away
To where a dooli lay,
An’ a bullet came and drilled the beggar clean.
’E put me safe inside,
An’ just before ’e died:
“I ’ope you like your drink,” sez Gunga Din.
So I’ll meet ’im later on
At the place where ’e is gone—
Where it’s always double drill and no canteen;
’E’ll be squattin’ on the coals,
Givin’ drink to poor damned souls,
An’ I’ll get a swig in hell from Gunga Din!
Yes, Din! Din! Din!
You Lazarushian-leathern Gunga Din!
Though I’ve belted you and flayed you,
By the livin’ God that made you,
You’re a better man than I am, Gunga Din!

THE TRUE BALLAD OF THE KING’S SINGER


By Helen Hunt Jackson

The king rode fast, the king rode well,


The royal hunt went loud and gay,
A thousand bleeding chamois fell
For royal sport that day.

When sunset turned the hill all red,


The royal hunt went still and slow;
The king’s great horse with weary tread
Plunged ankle-deep in snow.

Sudden a strain of music sweet,


Unearthly sweet, came through the wood;
Up sprang the king, and on both feet
Straight in his saddle stood.

“Now, by our lady, be it bird,


Or be it man or elf that plays,
Never before my ears have heard
A music fit for praise!”

Sullen and tired, the royal hunt


Followed the king, who tracked the song,
Unthinking, as is royal wont,
How hard the way and long.

Stretched on a rock the shepherd lay


And dreamed and piped, and dreamed and sang,
And careless heard the shout and bay
With which the echoes rang.

“Up, man! the king!” the hunters cried.


He slowly stood, and, wondering,
Turned honest eyes from side to side:
To him, each looked like king.

Strange shyness seized the king’s bold tongue;


He saw how easy to displease
This savage man who stood among
His courtiers, so at ease.

But kings have silver speech to use


When on their pleasure they are bent;
The simple shepherd could not choose;
Like one in dream he went.

O hear! O hear! The ringing sound


Of twenty trumpets swept the street,
The king a minstrel now has found,
For royal music meet.

With cloth of gold, and cloth of red,


And woman’s eyes the place is bright.
“Now, shepherd, sing,” the king has said,
“The song you sang last night!”

One faint sound stirs the perfumed air,


The courtiers scornfully look down;
The shepherd kneels in dumb despair,
Seeing the king’s dark frown.

The king is just; the king will wait.


“Ho, guards! let him be gently led,
Let him grow used to royal state,—
To being housed and fed.”

All night the king unquiet lay,


Racked by his dream’s presentiment;
Then rose in haste at break of day,
And for the shepherd sent.

“Ho, now, thou beast, thou savage man,


How sound thou sleepest, not to hear!”
They jeering laughed, but soon began
To louder call in fear.

They wrenched the bolts; unrumpled stood


The princely bed all silken fine,
Untouched the plates of royal food,
The flask of royal wine!

The costly robes strewn on the floor,


The chamber empty, ghastly still;
The guards stood trembling at the door,
And dared not cross the sill.

All night the sentinels their round


Had kept. No man could pass that way.
The window dizzy high from ground;
Below, the deep moat lay.

They crossed themselves. “The foul fiend lurks


In this,” they said. They did not know
The miracles sweet Freedom works,
To let her children go.

It was the fiend himself who took


That shepherd’s shape to pipe and sing;
And every man with terror shook,
For who would tell the king!
The heads of men all innocent
Rolled in the dust that day;
And east and west the bloodhounds went,
Baying their dreadful bay;

Safe on a snow too far, too high,


For scent of dogs or feet of men,
The shepherd watched the clouds sail by,
And dreamed and sang again;

And crossed himself, and knelt and cried,


And kissed the holy Edelweiss,
Believing that the fiends had tried
To buy him with a price.

The king rides fast, the king rides well;


The summer hunts go loud and gay;
The courtiers, who this tale can tell,
Are getting old and gray.

But still they say it was a fiend


That took a shepherd’s shape to sing,
For still the king’s heart is not weaned
To care for other thing.

Great minstrels come from far and near,


He will not let them sing or play,
But waits and listens still to hear
The song he heard that day.

—Copyright by Little, Brown & Co., Boston, and used by kind


permission.

THE DREAM OF CLARENCE


By William Shakespeare

O, I have passed a miserable night,


So full of ugly sights, of ghastly dreams,
That, as I am a Christian faithful man,
I would not spend another such night,
Though ’twere to buy a world of happy days,
So full of dismal terror was the time!

Methought that I had broken from the tower,


And was embark’d to cross to Burgundy;
And, in my company, my brother Gloucester;
Who from my cabin tempted me to walk
Upon the hatches: thence we looked toward England,
And cited up a thousand fearful times,
During the wars of York and Lancaster,
That had befallen us.

As we paced along
Upon the giddy footing of the hatches,
Methought the Gloucester stumbled; and, in falling,
Struck me, that thought to stay him, overboard,
Into the tumbling billows of the main.
Lord! Lord! methought, what pain it was to drown!
What dreadful noise of waters in mine ears!
What ugly sights of death within mine eyes!

Methought I saw a thousand fearful wrecks;


Ten thousand men that fishes gnawed upon;
Wedges of gold, great anchors, heaps of pearl,
Inestimable stones, unvalued jewels,
All scattered in the bottom of the sea:
Some lay in dead men’s skulls; and in those holes
Where eyes did once inhabit, there were crept,
As ’twere in scorn of eyes, reflecting gems,
Which woo’d the slimy bottom of the deep,
And mock’d the dead bones that lay scattered by.

Methought I had, and often did I strive


To yield the ghost: but the envious flood
Kept in my soul, and would not let it forth
To seek the empty, vast and wandering air;
But smothered it within my panting bulk,
Which almost burst to belch it in the sea.

My dream was lengthened after life;


O, then began the tempest of my soul,
Who pass’d, methought, the melancholy flood,
With that grim ferry-man which poets write of,
Unto the kingdom of perpetual night.
The first that did greet my stranger soul,
Was my great father-in-law, renowned Warwick;
Who cried aloud, “What scourge for perjury
Can this dark monarchy afford false Clarence?”

And so he vanished: then came wandering by


A shadow like an angel, with bright hair
Dabbled in blood; and he squeaked aloud,
“Clarence is come; false, fleeting, perjured Clarence,
That stabb’d me in the field by Tewksbury:
Seize on him, Furies, take him to your torments!”
With that, methought, a legion of foul fiends
Environ’d me about, and howled in mine ears
Such hideous cries, that with the very noise
I trembling waked, and for a season after
Could not believe but that I was in hell,
Such terrible impression made the dream.

THE BLACKSMITH OF LIMERICK


By Robert Dwyer Joyce

He grasped the ponderous hammer, he could not stand it more,


To hear the bomb-shells bursting, and thundering battle’s roar;
He said, “The breach they’re mounting, the Dutchman’s murdering
crew—
I’ll try my hammer on their heads, and see what that can do!
“Now, swarthy Ned and Moran, make up that iron well;
’Tis Sarsfield’s horse that wants the shoes, so mind not shot or
shell;”
“Ah, sure,” cried both, “the horse can wait, for Sarsfield’s on the wall
And where you go we’ll follow, with you to stand or fall!”

The blacksmith raised his hammer, and rushed into the street,
His ’prentice boys behind him, the ruthless foe to meet;—
High on the breach of Limerick with dauntless hearts they stood,
Where bomb-shells burst, and shot fell thick, and redly ran the blood.

“Now look you, brown-haired Moran; and mark you, swarthy Ned,
This day we’ll prove the thickness of many a Dutchman’s head!
Hurrah! upon their bloody path, they’re mounting gallantly;
And now the first that tops the breach, leave him to this and me.”

The first that gained the rampart, he was a captain brave,—


A captain of the grenadiers, with blood-stained dirk and glaive;
He pointed and he parried, but it was all in vain!
For fast through skull and helmet the hammer found his brain!

The next that topped the rampart, he was a colonel bold;


Bright, through the dust of battle, his helmet flashed with gold—
“Gold is no match for iron,” the doughty blacksmith said,
And with that ponderous hammer he cracked his foeman’s head.

“Hurrah for gallant Limerick!” black Ned and Moran cried,


As on the Dutchmen’s leaden heads their hammers well they plied;
A bomb-shell burst between them—one fell without a groan,
One leaped into the lurid air, and down the breach was thrown.

“Brave smith! brave smith!” cried Sarsfield, “beware the treacherous


mine!
Brave smith! brave smith! fall backward, or surely death is thine!”
The smith sprang up the rampart and leaped the blood-stained wall,
As high into the shuddering air went foeman, breach and all!

Up, like a red volcano, they thundered wild and high,—


Spear, gun, and shattered standard, and foeman through the sky;
And dark and bloody was the shower that round the blacksmith fell;

He thought upon his ’prentice boys,—they were avengèd well.

On foeman and defenders a silence gathered down;


’Twas broken by a triumph shout that shook the ancient town,
As out its heroes sallied, and bravely charged and slew,
And taught King William and his men what Irish hearts could do.

Down rushed the swarthy blacksmith unto the river’s side,


He hammered on the foe’s pontoon, to sink it in the tide;
The timber, it was tough and strong, it took no crack or strain;
“Mavrone! t’won’t break!” the blacksmith roared; “I’ll try their heads
again!”

He rushed upon the flying ranks; his hammer ne’er was slack,
For in thro’ blood and bone it crashed, thro’ helmet and thro’ jack;
He’s ta’en a Holland captain beside the red pontoon,
And “Wait you here,” he boldly cries; “I’ll send you back full soon!

“Dost see this gory hammer? It cracked some skulls to-day,


And yours ’twill crack, if you don’t stand and list to what I say;—
Here! take it to your cursèd King, and tell him, softly, too,
’Twould be acquainted with his skull if he were here, not you!”

The blacksmith sought his smithy and blew his bellows strong;
He shod the steed of Sarsfield, but o’er it sang no song;
“Ochone! my boys are dead!” he cried; “their loss I’ll long deplore,
But comfort’s in my heart, their graves are red with foreign gore.”

HYMN OF THE IMPERIAL GUARD


By Bartholomew Dowling

Up, comrades, up, the bugle peals the note of war’s alarms,
And the cry is ringing sternly round, that calls the land to arms;
Adieu, adieu, fair land of France, where the vine of Brennus reigns;
We go where the blooming laurels grow, on the bright Italian plains.
Advance! advance! brave sons of France, before the startled world;
For France, once more, her tricolor in triumph hath unfurled.

Our eagles shall fly ’neath many a sky, with a halo round their way
Where History flings, on their flashing wings, the light of Glory’s ray;
And we shall bear them proudly on, through many a mighty fray,
That shall win old nations back to life, in the glorious coming day.
Then advance, advance, ye sons of France, before the startled
world,
For France, once more, her tricolor in triumph hath unfurled.

The glowing heart of the land of Art, throbbing for Liberty,


Our swords invoke, to erase the yoke from beauteous Italy.
And the Magyar waits, with kindling hope, the aid of the Gallic hand,
To drive the hated Austrians forth, from the old Hungarian land.
Then advance, advance, ye sons of France, before the startled
world,
For France, once more, her tricolor in triumph hath unfurled.

See the Briton, pale, as he dons his mail, for the coming conflict
shock,
And before his eyes, see the phantom rise, of the Chief on Helena’s
rock;
In foreboding fears, already he hears through palace and mart anew,
Our avenging shout, o’er the battle rout—remember Waterloo!
Then advance, advance, ye sons of France, before the startled
world,
For France, once more, her tricolor in triumph hath unfurled.
And, hark, a wail from our kindred Gael, comes floating from the
West—
That gallant race, whose chosen place was ever our battle’s crest;
Now is the day we can repay the generous debt we owe
To Irish blood, that freely flowed to conquer France’s foe.
Then advance, advance, ye sons of France, before the startled
world,
For France, once more, her tricolor in triumph hath unfurled.
Old Tricolor, as in days of yore, you shall wave o’er vanquished
kings,
And your folds shall fly ’neath an English sky, on Victory’s crimson
wings;
And Europe’s shout shall in joy ring out, hailing freedom in thy track,
When our task is done, and we bear thee on, to France with glory
back.
Then advance, advance, ye sons of France, before the startled
world,
For France, once more, her tricolor in triumph hath unfurled.

THE DEATH-SONG OF THE VIKING[15]


By Bartholomew Dowling

My race is run, my errand done, the pulse of life beats low;


My heart is chill, and the conquering will has lost its fiery glow:
Launch once again on the northern main my battleship of old:
I would die on the deck, ’mid storm and wreck, as befits a Viking
bold.

I know no fears, but the mist of years that has gathered round my
track
For a moment clears, and my youth’s compeers again to my side
come back;
And the tall ships reel o’er their iron keel, as we sweep down on the
foe,
Like a giant’s form amid the storm, where the mighty tempests blow.

Again I gaze on the leaping blaze o’er a conquered city rise,


As in those days, when the Skald’s wild lays, sang the fame of our
high emprise;
When our ships went forth from the stormy North with the
Scandinavian bands
Who backward bore to the Baltic’s shore the spoil of the Western
lands.
But my race is run, my errand done; so bear me to my ship.
Place my battle-brand in this dying hand, and the wine-cup to my lip;
Then loose each sail to the rising gale and lash the helm a-lee.
Alone, alone, on my drifting throne, I would view my realm, the sea.

My realm and grave the northern wave, where the tempest’s voice
will sing
My death-song loud, where flame shall shroud the ocean’s warrior-
king,
Whilst heroes wait at Valhalla’s gate to proudly welcome me.
For my race is run, my errand done. Receive thy Chief, O Sea!

THE RIDE OF JENNIE McNEAL


By Will Carleton

Paul Revere was a rider bold—


Well has his valorous deed been told;
Sheridan’s ride was a glorious one—
Often it has been dwelt upon.
But why should men do all the deeds
On which the love of a patriot feeds?
Hearken to me, while I reveal
The dashing ride of Jennie McNeal.

On a spot as pretty as might be found


In the dangerous length of the Neutral Ground,
In a cottage cosy, and all their own,
She and her mother lived alone.
Safe were the two, with their frugal store,
From all of the many who passed their door;
For Jennie’s mother was strange to fears,
And Jennie was large for fifteen years.

One night, when the sun had crept to bed,


And rain-clouds lingered overhead,
And sent their surly drops for proof
To drum a tune on the cottage roof,
Close after a knock at the outer door,
There entered a dozen dragoons or more.
Their red coats, stained by the muddy road,
That they were British soldiers showed;

The captain his hostess bent to greet,


Saying, “Madam, please give us a bit to eat;
We will pay you well, and, if may be,
This bright-eyed girl for pouring our tea;
Then we must dash ten miles ahead,
To catch a rebel colonel abed.
He is visiting home, as doth appear;
We will make his pleasure cost him dear.”
And they fell on the hasty supper with zeal,
Close-watched the while by Jennie McNeal.
For the gray-haired colonel they hovered near,
Had been her true friend, kind and dear;
So sorrow for him she could but feel,
Brave, grateful-hearted Jennie McNeal.

With never a thought or a moment more,


Bare-headed she slipped from the cottage door,
Ran out where the horses were left to feed,
Unhitched and mounted the captain’s steed,
And down the hilly and rock-strewn way
She urged the fiery horse of gray.
Around her slender and cloakless form
Pattered and moaned the ceaseless storm;
Secure and tight, a gloveless hand
Grasped the reins with stern command;
And full and black her long hair streamed,
Whenever the ragged lightning gleamed;
And on she rushed for the colonel’s weal,
Brave, lioness-hearted Jennie McNeal.

Hark! from the hills, a moment mute,


Came a clatter of hoofs in hot pursuit;
And a cry from the foremost trooper said,
“Halt! or your blood be on your head!”
She heeded it not, and not in vain
She lashed the horse with the bridle-rein.
So into the night the gray horse strode;
His shoes hewed fire from the rocky road;
And the high-born courage that never dies
Flashed from his rider’s coal-black eyes.
The pebbles flew from the fearful race;
The rain-drops grasped at her glowing face.
“On, on, brave beast!” with loud appeal,
Cried eager, resolute Jennie McNeal.

“Halt!” once more came the voice of dread;


“Halt! or your blood be on your head!”
Then, no one answering to the calls,
Sped after her a volley of balls.
They passed her in her rapid flight,
They screamed to her left, they screamed to her right;
But, rushing still o’er the slippery track,
She sent no token of answer back,
Except a silvery laughter-peal,
Brave, merry-hearted Jennie McNeal.

So on she rushed, at her own good will,


Through wood and valley, o’er plain and hill;
The gray horse did his duty well,
Till all at once he stumbled and fell,
Himself escaping the nets of harm,
But flinging the girl with a broken arm.
Still undismayed by the numbing pain,
She clung to the horse’s bridle-rein,
And gently bidding him to stand,
Petted him with her able hand;
Then sprang again to the saddle-bow,
And shouted, “One more trial now!”
As if ashamed of the heedless fall,
He gathered his strength once more for all,
And, galloping down a hillside steep,
Gained on the troopers at every leap.
No more the high-bred steed did reel,
But ran his best for Jennie McNeal.
They were a furlong behind, or more,
When the girl burst through the colonel’s door,
Her poor arm helpless, hanging with pain,
And she all drabbled and drenched with rain,
But her cheeks as red as fire-brands are,
And her eyes as bright as a blazing star,
And shouted, “Quick! be quick, I say!
They come! they come! Away! away!”
Then sank on the rude white floor of deal,
Poor, brave, exhausted Jennie McNeal.

The startled colonel sprang, and pressed


His wife and children to his breast,
And turned away from his fireside bright;
And glided into the stormy night;
Then soon and safely made his way
To where the patriot army lay.
But first he bent, in the dim firelight,
And kissed the forehead broad and white,
And blessed the girl who had ridden so well
To keep him out of a prison-cell.
The girl roused up at the martial din,
Just as the troopers came rushing in,
And laughed, e’en in the midst of a moan,
Saying, “Good sirs, your bird has flown.
’Tis I who have scared him from his nest;
So deal with me now as you think best.”
But the grand captain bowed, and said,
“Never you hold a moment’s dread.
Of womankind I must crown you queen;
So brave a girl I have never seen.
Wear this gold ring as your valor’s due;

You might also like