Posted by: episystechpubs | October 14, 2014

Editor’s Corner: More Plain English

Hello! I’m back to tell you about the rest of the plain English standards from the JHA Style Guide for Technical Communication and Training. Here we go!

· Write as specifically as possible

o Incorrect: If you accept the default of 0 at this prompt, the specfile will not omit any open accounts based on the value in the Warning Code.

o Correct: If you accept the default of 0 at this prompt, the specfile will not omit any open accounts based on the value in the Warning Code field in the Account record.

· Break up noun clusters that have more than three nouns

o Incorrect: JHA is developing an interdepartmental employee relations improvement plan.

o Correct: JHA is developing a plan to improve relations among employees in different departments.

· Always start a paragraph with a topic sentence [JS] The first sentence in the paragraph should tell the reader what the rest of the paragraph is about.

· If anything in a paragraph does not support the topic sentence, create a new paragraph for the new information

· If you begin a command with a dependent clause, separate it from the main clause with a comma

o Incorrect: On the Tools menu select Options.

o Correct: On the Tools menu, select Options.

· Begin a caution with a simple and clear command

o Incorrect: Once locked, the Forecast cannot be unlocked.

o Correct: Make sure you have made all the needed changes to the Forecast. Once locked, the Forecast cannot be unlocked.

· Do not leave out articles

o Incorrect: ODP system has set minimum for all methods.

o Correct: The ODP system has a set minimum for all methods.

Jackie Solano | Technical Editor | Symitar®

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

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 )

Twitter picture

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

Facebook photo

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

Google+ photo

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

Connecting to %s

Categories

%d bloggers like this: