Technical writing style

Technical Writing Style As you draft and edit, it is helpful to prevent in mind the effective ways to present sentences and paragraphs. When you revise your drafts, check the language and remove either area of possible confusion. If you have repeated any word, see whether you can change the sentence. The following passages will help you to be aware of any difficult construction of sentences, so that you can modify the selfsame(prenominal) and ensure readers comfort. Write Clear Sentences Follow these guidelines for write sentences which will be clear to the readers. Keep the main idea on top. role active give tongue to.Employ parallelism. cite for emphasis. Write sentences of 15 to 25 delivery. Provide transitions. void wordiness. Avoid redundancy. Keep the Main Idea on Top This is the pick out doctrine in writing so that your sentences are easy to understand. Place the sentences main idea, the base, beginning(a). The overpower makes the rest of the sentence accessible. Readers therefore orient themselves and they are able to interact with the subsequent discussion. cipher this pillow slip from a popular newspaper. Doubts persist oer World Cup 2007. ( none how the interest of the reader is immediately captured. Now the details follow. )Clouds are gathering over the West Indies, and they are more than rain-bearing masses of cumulous. With eight months and a few days to go for the 2007 World Cup, doubts are increasingly being aired closely the ability of the region to host a venture of such and complexity. Thus readers are informed about the crux of the problem so that they are kindle to read on. Use Normal Word Order The normal word order in English is subject-verb-object. This order makes it easier to read as it reveals the topic first and the structures the idea.This order produces entences which are clear to the readers and do not cause any contusion. Read the following sentence. Finance Minister on Tuesday backed the Central Banks conclu sion to add-on interest rates, stating that the move was aimed at containing inflation. The sentence is clear, though a little long (23 words) and follows natural flow. Use Active Voice Active voice emphasizes performer of the function and not the receiver. Active voice helps the reader follow the meaning quickly as it is sticking to subject-verb-object pattern. When the subject acts, the verb is in the active voice.When the subject is acted upon, the verb is in the passive voice. Use passive voice sparingly and when it is absolutely required. Examples I completed the work in time (active voice as the subject acts here. ) My mobile was stolen (passive voice as the subject is acted upon. ) Go through the following example. Manufacturers add preservatives to food products to increase their shelf-life (emphasis is on manufacturers, which is not correct. ) Preservatives are added to food products to increase their shelf-life (emphasis is on preservatives, which is correct. In uch cases , passive voice should be used. Use Parallelism Use similar structures for similar elements. The vendors promise that they will replace the old railcar and to attend to the new order (wrong). The vendors promise that they will replace the old machine and will attend to the new order. (correct) Repeat for Emphasis Repeat key words for emphasis so that the reader has better recall. Read the following example. The doctrine of No work, no pay is a fundamental axioms in industrial relations. The philosophy is very simple. When a person is employed, he is expected to carry out the ork assigned to him.When he does not do so, he is not eligible for payment of any salary. Even when a general strike disrupts public transport systems, and consequently employees are unable to reach their work places, the same principle prevails. Of course corporate may permit their staff to avail themselves of any leave to their credit. Even die-hard trade union leaders respect this principle. No work, no pay lays a strong foundation to industrial peace and harmony in the long run. Provide Transitions Connect sentences by using words that signal a sequence or pattern. Sequence first, second, next.Addition and, further. Contrast but, however, nevertheless. Avoid Wordiness Generally, concise expressions are more effective than verbosity. Eliminate all repetitions, hyponym clauses etc. to make the writing compact and pointed. Examples of Wordiness Came to the conclusion Utilization of Make Revisions Make an amendment to Examples of compactness Concluded Use Revise Amend Avoid Redundancy Redundancies are words that say the same content. Conciseness is achieved by saying anything only once. In the following examples, what is bracketed may be mitted for conciseness.During (the year) of 2006 (Needless to say) (New) innovation The (other) resource is Choose a Tone Now you can prepare clear, effective documents. Your documents are easy to read. However, we are assuming that the author and read er are get even and unemotional. In practice, it may not be so. Hence it is important to control tone. The tone can communicate as much as the content of the message. Consider almost possible tones depending on the situation. forceful passive personal impersonal The forceful tone implies that the writer is in command.This is appropriate when the writer addresses subordinates. While writing forcefully, Use the active voice. Use imperatives. Clearly indicate that you are responsible. For example I have decided to introduce Performance Appraisal System forthwith in our organization. When the reader has more power than the writer, use passive voice. For example The instructions to use the new Evaluation System has been complied with The personal tone implies that reader and writer are equal. David thanks for your suggestion about maintenance routine. It has given good results.The impersonal tone is employed when the writer is not important and the situation is neutral. For example A proposal to introduce quality circle has been made. Use Positive Words and Verbs A sure way to involve your audience is to sprinkle irresponsible words and positive verbs throughout your text. Positive words and verbs convince the reader the benefits of your subject matter. Positive Words Advantage asset effective profitable quenched value favorable success Benefit Positive Verbs Positive verbs motivate your readers. Some ot the verbs that motivate your readers nto action are here.Accomplish plan achieve produce implement Prepare promote exceed organize assess Tune to the Audience Tuning to the audience is the key for effectiveness of your document with the reader. Remember the following points. Not all your readers will understand acronyms and abbreviations. Readers need glossaries. Provide extended definitions for technical terms. As multiple audiences have different levels of technical knowledge, choose carefully the cadence of technical content in your document. Show your rea der how he or she will benefit from your document