Technical Writing ToolBox

A Blog on Technical Writing

Tag Archives: Writing Tip

7 causes of Inefficient Writing

Few weeks back I talked about three external factors that gives birth to inefficient documents.  Writers either have no or very less control over these factors. However, this is not always the case. In fact, usually a writer makes documents inefficient if they fail to remove common writing mistakes from their work. Let’s look at seven  factors that cause inefficient writing even when the content is technically accurate and the grammar is perfect:

Read more >>

Advertisements

Top 3 Serial Killers of a Good Document

Don’t kill me- says your document!

Whether you are writing a user’s guide, online help, or an installation guide, you always strive to convey a meaningful message to your intended audience.

However, the message often gets diluted and becomes meaningless due to a number of reasons. Of course, a writer may not put enough efforts in making a message meaningful but most of the time several external factors contribute in killing the effectiveness of a document. Let’s look at the top three factors that kill a good document:

Read more >>

7 Useful Insights about How People Read Documentation

Reading is a primary form of communication for most people and they have different habits of reading. Not surprisingly, different people read product documentation in different ways. But how do they read and why should we care about their reading habits?

A writer writes with a purpose. This purpose gives shapes to their thoughts and allows them to convert their body-less thoughts to words. A strong correlation exists between a writer’s purpose and use of the document.

Read more >>

Getting Rid of Misplaced Modifiers

Modifiers are words, phrases, or clauses that restricts or provide additional information about other words, phrases, or clauses. Modifiers can be adjectives or adverbs. Modifiers that appear before the head are called premodifiers and modifiers that appear after the head are called postmodifiers.

We have a certain amount of freedom in deciding where to place our modifiers in a sentence:

We rowed the boat vigorously.
We vigorously rowed the boat.
Vigorously we rowed the boat.

Read more >>

Make your Sentences Slim (by removing 35 Wordy Phrases)

Photo Credit: OnBloggingWell.com

One of the easiest way to achieve conciseness in your writing is by removing wordy phrases. Wordy Phrases are long sentences that can be replaced by a single word (or few words) without changing the meaning of a sentence.
Read more >>

%d bloggers like this: