Using Parallel Construction in Technical Documents

The careful technical writer always uses parallel construction in paragraphs, lists, even sentences. For sentences that is just good grammar. So what is parallel construction?

Parallel Sentences

According to my oldest text book on technical writing, a sentence is parallel if its coordinate elements are expressed in the same grammatical form. By creating and sustaining a recognizable pattern for the reader, parallelism makes the sentence easier to follow.

The Global English Style Guide calls parallel structure ‘using syntactic cues,’ which is essentially saying the same thing as the previous paragraphs. However, by saying ‘syntactic cues,’ you can really see that the way something is written becomes part of the syntax, or pattern, of the document.

Here are some examples:

Nonparallel statements

Parallel statements

That should give you some idea about parallel sentence structures. Now let’s look at parallel lists.

Parallel Lists

Parallel structure in lists means that the list has a standard pattern throughout. The following incorrect example is pretty egregious but, you get the point.

Incorrect

Windows offers several ways to open documents:

Correct

Windows offers several ways to open documents:

Notice that in each correct example, the sentences are imperative. Believe it or not, despite how you feel when it is your mother talking, readers prefer the imperative.

Parallelism in Paragraphs, Topics, and Documents

The best way to make your reader feel comfortable is to establish a pattern for all of the information. All of the paragraphs in the same section should have the same voice and mood. All of the topics should follow the same pattern. All the documents should have the same structure. This eliminates the drama from the writing but, let’s face it, when you need information now, who needs drama?

For example, if your document has a chapter that starts with a heading, a brief introductory sentence, and a list of the information that is in the chapter. All chapters should have that structure. Otherwise, it is very obvious that you have multiple authors or a totally scatterbrained person writing your document. The bonus is that, once you establish a pattern, it is easier to write as well as read.

Additionally, once you have established a pattern, readers can pay attention to the information and not even notice the writing. Isn’t that the goal of real technical writers? If it isn’t, it certainly should be.


Source
Exit mobile version