Education and Career for Youth

Posts Tagged ‘technical’

Have you ever wondered who writes all those instruction manuals, owner’s manual and instruction booklets that accompany your computers, exercise machines, power tools, computer software and even your universal remote control? Introducing the techie side of a product or service and teaching the how-to procedures is the job of a technical writer. It’s one of the fastestgrowing job markets today and good, experienced talents are always in demand. If this is your dream job, learn more about what it takes to have a successful technical writer career:

What You Do
As a technical writer, your responsibility would be to research, analyze, obtain, plan and deliver data and other information in a specific and orderly manner to make it understandable to the target market. You also need to prepare written documentation that delivers technical information in a clear and concise manner.

Requirements
A good grasp of the written language is an important requirement for a successful career and so is the ability to translate an idea or concept into a series of detailed information and procedures that are easy to understand. It’s also important to have excellent research skills. In terms of education, most writers have some educational background or work experience in the industry where they work. If a technical writer creates a manual on medical procedures, for example, he/she must have a background in the medical industry. Many writers also work in fields such as medicine, biology, law, aviation, education, religion, chemistry, physics, engineering and technology. Many are also hired by government agencies.

Read the rest of this entry »

Technical writing is a specialised form of writing.

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

So within the technical writing genre, you will find: technical reports, installation and maintenance manuals, proposals, white papers, on-line help, process standards, work instructions and procedures.

While each discipline has its specific requirements, some basic elements are common. But before looking at those, the most important thing a technical writer must consider is the audience.

Audience:

How familiar are readers with the subject and with the specialised terms and abbreviations you need to use?
What is the best way to explain those terms or shortened forms – footnotes, endnotes, glossary, table of abbreviations, appendix, links?
Do you need to accommodate secondary readers (e.g. the manager or financier who will make the decision about the proposal), and how will you do that?
Now for those all-important elements:

Clarity – The logical flow of the document will help readers understand the content. It can be useful to ask someone who is not familiar with the topic to review your writing before you finalise it. Using headings, illustrations, graphs or tables can be useful – your aim is to make it as easy as possible for your readers to understand what you’ve written. Consider how the way the text sits on the page or screen – another clue to maximising clarity for your readers.
Accuracy – The information and the interpretation of data that you present must be accurate. If it’s not, your readers will question the credibility of the content. Be careful to clearly differentiate between fact and opinion, and to accurately cite references to other works.
Brevity – Strive to find the balance between the amount of information presented and the time needed to read the document. Remember that you can use an appendix or link to provide supplementary or background information. Consider using an illustration, table or graph rather than words to explain a concept – but remember, if you use a ‘visual’, don’t give a long written explanation.
Sentence length – Generally, complex or unfamiliar concepts are best presented in shorter sentences. This will give readers time to digest small pieces of information before moving on to the next. While this can be difficult to achieve, try to aim for approximately 25 words per sentence. If you find you’ve written a series of long sentences, look for ‘and’, ‘but’, ‘however’ and similar words where you can break the sentence.
Paragraphs – The age-old rule about one topic per paragraph is a useful guide. That doesn’t mean that you can have only one paragraph for each topic, but it does mean that having only one topic in each paragraph makes for clear, logical writing.
Reader-centricity – You are writing for your readers. Make it as easy as possible for them to understand your work.
Keep these basic elements and other principles in mind as you undertake your technical writing tasks.

Technical writing is a specialised form of writing.

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

So within the technical writing genre, you will find: technical reports, installation and maintenance manuals, proposals, white papers, on-line help, process standards, work instructions and procedures.

While each discipline has its specific requirements, some basic elements are common. But before looking at those, the most important thing a technical writer must consider is the audience.

Audience:

How familiar are readers with the subject and with the specialised terms and abbreviations you need to use?
What is the best way to explain those terms or shortened forms – footnotes, endnotes, glossary, table of abbreviations, appendix, links?
Do you need to accommodate secondary readers (e.g. the manager or financier who will make the decision about the proposal), and how will you do that?
Now for those all-important elements:

Clarity – The logical flow of the document will help readers understand the content. It can be useful to ask someone who is not familiar with the topic to review your writing before you finalise it. Using headings, illustrations, graphs or tables can be useful – your aim is to make it as easy as possible for your readers to understand what you’ve written. Consider how the way the text sits on the page or screen – another clue to maximising clarity for your readers.
Accuracy – The information and the interpretation of data that you present must be accurate. If it’s not, your readers will question the credibility of the content. Be careful to clearly differentiate between fact and opinion, and to accurately cite references to other works.
Brevity – Strive to find the balance between the amount of information presented and the time needed to read the document. Remember that you can use an appendix or link to provide supplementary or background information. Consider using an illustration, table or graph rather than words to explain a concept – but remember, if you use a ‘visual’, don’t give a long written explanation.
Sentence length – Generally, complex or unfamiliar concepts are best presented in shorter sentences. This will give readers time to digest small pieces of information before moving on to the next. While this can be difficult to achieve, try to aim for approximately 25 words per sentence. If you find you’ve written a series of long sentences, look for ‘and’, ‘but’, ‘however’ and similar words where you can break the sentence.
Paragraphs – The age-old rule about one topic per paragraph is a useful guide. That doesn’t mean that you can have only one paragraph for each topic, but it does mean that having only one topic in each paragraph makes for clear, logical writing.
Reader-centricity – You are writing for your readers. Make it as easy as possible for them to understand your work.
Keep these basic elements and other principles in mind as you undertake your technical writing tasks.