terminology management

How not to Sacrifice Clarity to Simplicity in Technical Writing

Introduction

Simplicity in technical writing is a mantra frequently repeated by trainers and writing instructors.

You’ve heard it many times and in general, it’s true: “Write simply. Eliminate all unnecessary words and facts from your technical writing.”

Plain language is of course what we all like. But there are always exceptions in life, including this worthy principle.

It does not make sense to write in simple sentences if such simplicity leaves your audience scratching their heads and wondering what’s going on.

The way you write should not only convey what you want to say in a direct manner but also convey ALL you want to say, without dropping any significant pieces of information in the name of simplicity.

Role of Statistics

Statistics are often used by those who are trying to write simply and back up arguments. However, they can also be used to deceive. Not everyone who quotes numbers is talking clearly. Here are the following 4 ways you can spot a statistical lie detector test:

1) The sample size is too small

A sample size of less than 50 people is not statistically significant enough to make any claims. This means that in order for the data to be accurate, it would need to be at least 50 people in the study.

2) The sampling is biased.

Was the sample selected randomly?

3) There is no control group.

If the results of the subject group are not compared with those of the randomly selected control group, then the results don’t have any statistical significance.

4) There are no clear definitions of what constitutes an event or outcome.

If you do not define beforehand what will count as an “event” or an “observation,” then the outcome can be fudged according to changing definitions of an “event” or an “observation.”

What to Include?

What kind of information should you include, even if that leads to longer sentences or paragraphs?

Anything that would place your information in a larger CONTEXT and make the SIGNIFICANCE of the information clear. Include anything that would help your audience understand what the information really MEANS and if they should do anything about it.

For example:

“Average American factory worker earned $43,000 last year.”

Yes, but WHAT exactly does this mean? What’s the PURPOSE in sharing this information, expressed in a beautiful short sentence?
Compare that sentence to this paragraph:

“Average American factory worker earned $43,000 last year in contrast to ten years ago when the same figure stood at $45,000. Adjusted for the average annual inflation rate of 2.5%, that amounts to a net loss of $1,300 a year which reflects the hardships the manufacturing sector went through during the last decade due to stiff competition from China and EU countries.”

Isn’t it clearer now what that $43,000 figure represents and means?

Conclusion – Simplicity in Technical Writing

Albert has the last word:

“Everything should be kept as simple as possible, but no simpler.”  — Albert Einstein

MORE INFO

Key Concepts of Technical Writing to Create Great Documents
What is the Difference between Content Writing and Copywriting?
How to Write Cause and Effect Sentences and Paragraphs for Better Documents
How to Prevent Compounding Editing Errors
New Money-Making Opportunities for Writers
Technical Documentation Terms
Software Documentation Terms You Should Know As a Technical Communicator