Basic elements of technical writing

Technical Writing is a special form of writing

Its purpose is to help readers use a technology or understand a process, product or concept. Often, these processes, products or concepts are complex, but should be much simpler, reader-friendly.

So in the technical engineering genre there are technical reports, installation and maintenance manuals, suggestions, white papers, on-line help, process standards, sessions and procedures

While each discipline has its specific requirements, some basic elements are common. But before looking at these, the most important thing a technical writer needs to take into account is the audience. What kind of readers are familiar with the topic and the specialists with which terms and abbreviations should be used?

  • Which is the best way to explain these terms or abbreviated forms – footnotes, endings, glossaries, abbreviations tables, appendices, links?
  • Do you need to receive secondary readers (eg the manager or financier who makes the decision on the proposal) and how will you do that?
  • Now for all the important elements:

    1. Clarity – The logical flow of the document helps readers understand the content. It may be helpful to ask a person who does not know the subject to check his writing before finalizing it. Using headers, illustrations, charts, or tables can be useful – the goal is to make it as easy as readers to understand what they are writing. Consider how the text appears on the page or on the screen – yet another tip to maximize readers' clarity.
    2. Accuracy – The information and interpretation of the information you provide must be accurate. If not, the reader questions the credibility of the content. Be careful to make a clear distinction between facts and opinions and accurately refer to references to other works.
    3. Brevity – Let's strive to find the balance between the amount of information presented and the time to read the document. Remember to use a supplementary or mass storage attachment or link. Do not use an illustration, table or graph instead of words to explain a concept – but do not forget to use a "visual" term, do not give a long written explanation. – Usually, complex or unknown concepts are in the shortest sentences. This gives readers time to digest little information before moving on. Although it can be difficult to reach, try around. To say 25 words. If you find that you have long sentences written, find "and", "but", "but" and similar words where you can interrupt the sentence. old paragraph one item in one paragraph useful guide. This does not mean that only one paragraph can be assigned to each topic, but this means that the single topic in each paragraph allows a clear, logical write. Writing reader-centricity to readers. It's as easy as you can to understand your job.

    Keep these basic elements and other principles in mind while taking technical writing tasks.

    Source by sbobet

    Leave a Reply

    Your email address will not be published. Required fields are marked *