Posted by: Jack Henry | February 2, 2017

Editor’s Corner: Keep Noun Strings Short

Kara has written about avoiding noun strings before, but I’m mentioning it again because it is a common problem in technical writing. Stringing nouns together can make your writing unclear and confuse readers.

Also, the JHA Style Guide for Technical Communication and Training(Plain English Standards) has a standard for noun strings:

Guideline Example
Break up noun clusters that have more than three nouns. Not this: The Work with Warehouse Selection Company ID field.

But this: The Company ID field on the Work with Warehouse Selection option.

You can avoid noun strings by including prepositions and articles or by changing some of the nouns to adjectives or verbs.

Here are some more examples:

Original:

Use the input message destination transaction code as shown in the example.

Revision:

Use the transaction code for the destination of an input message as shown in the example.

Original:

Please schedule a meeting to discuss employee compensation level evaluation procedures.

Revision:

Please schedule a meeting to discuss procedures for evaluating the compensation level of employees.

Jackie Solano | Technical Editor | Symitar®

8985 Balboa Ave. | San Diego, CA 92123 | Ph. 619.542.6711 | Extension: 766711

Symitar Documentation Services

NOTICE: This electronic mail message and any files transmitted with it are intended
exclusively for the individual or entity to which it is addressed. The message,
together with any attachment, may contain confidential and/or privileged information.
Any unauthorized review, use, printing, saving, copying, disclosure or distribution
is strictly prohibited. If you have received this message in error, please
immediately advise the sender by reply email and delete all copies.


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

Categories

%d bloggers like this: