Saturday, April 1, 2017

Technical Writing


Technical writers are those who write technical and software manuals, handbooks, technical guides and provide online help; anyone who writes about technology for other people is typically referred to as a technical writer. Technical documents must be clear and concise. A technical writer is someone who explains the product to the end user. They put themselves in the end use’s position and write to explain to them.

There are four “musts” for a technical writer.  The writer must have facility with the technology and latest scientific systems. He must have the ability to write clearly. He must have the talent to show ideas graphically, he must have patience introubleshooting and he must have the ability to interact with subject matter experts.Technical writers write about almost everything from informational brochures to scientific journals and web blogs. There’s a great future for technical writers.

Analyzing the Audience

Knowing about a person you are writing is of a vital importance. If you don’t understand your audience, you will not be able to communicate to them properly. You can havesurveys and questionnaires and opinions to form a picture of your audience in your mind. You have to transfer what is in the heads of the creators of the product, into the heads of the people using the product. The marketing department usually has a clear idea of the intended buyers of the software. They should be able to describe them to you in some detail, including demographic information and what kinds of similar products they have used in the past. Getting this information is a good first step to understanding your audience.

Researching the subject

Subject Matter Experts (SMEs) have information. Your job as a technical writer is to transfer that information to other people. First you’ll have to learn what they know. This is crucial to your success, so you have to know how to get along with these experts. So you need to befriend them in order to succeed well in this enterprise. You should interview these guys to find as much relevant information as possible. You should personally meet these people not email them. These people are highly intellectually enlightened about their fields of practice.

Structure of Information

If you are structuring information, you can describe the product or explain it in terms of instructions – each technique is selected according to the nature of product. Thus information without a clear structure means nothing to the reader. So finally information that is acquired after much struggle must be structured well.

Writing clearly

The purpose of a technical writing is not to impress but to inform and the more clearly and concisely you write, the more effective and digestible information will be. In order to do that you must use your audience’s vocabulary so that you meet words which they already know. The length of sentence is very important. The sentences for informational writing should be short and the average sentence length is usually between 15 to 20 words. Don’t write fillers in writing because the reader is reading it to fulfill a particular task, you writing should be direct and clear. There should be no redundancy or verbosity. You should always use a present indefinite tense as a general rule. For example, “Click any file and your file opens”.
  • Click to open the program
  • Click a file to open it.
  • Select Rename from the Edit menu.
  • Enter the name and click Close.
  • Type a new file name.
  • Click Save.
  • Click to exit.
Write as simply as possible and avoid jargons.


Always be cooperative, this is not the time to show your ego of excessive knowledge of English but to meet a particular demand.  You write to help people do their job—You are a conduit not a fountain, you take information from the SMEs, provide it to the audience and then let it go. Nothing you write is “precious”. If it’s not useful to the audience, delete it.


Technical writing is a highly-paid profession which you can get after a learning some specific skills and knowledge.

People who read this post also read :


Thomas Driscoll said...

Their fundamental need and keep away from the impact of extra variables to their instructive execution as it is a wrong approach to give training to understudies. Establishments must need to give better foundation offices to their understudies also.reword my essay

run 3 said...

Good article, it helps me a lot in the work.

steve said...

Thanks for share this POST see also:

شركة مكافحة حشرات
شركة تنظيف بالمدينة المنورة شركة تنظيف بالمدينة المنورة
شركة مكافحة حشرات بالمدينة المنورة شركة مكافحة حشرات بالمدينة المنورة
ارخص شركة نقل عفش بالمدينة المنورة ارخص شركة نقل عفش بالمدينة المنورة
افضل شركة تسليك مجارى بالرياض
ارخص شركة تنظيف بالدمام
شركة تنظيف بينبع

Wilson Schultz said...

O I love snow and I am astonish that why you hate snow ! One of my essay writing find this subordinate is really big fan of your posts.Its worth reading post.

Rick Cohen said...

Made me feel sad, look like he was a really good guy. May his soul rest in peace. Nice share of your toughts. i liked reading the article. thanks for sharing with us

Tracy Castro said...

Amazing images, the stock market business is something i tried alot but can never understand it site. all i know is that bearish and bullish trends are the signs of move in the market.

Post a Comment

Please leave your comments!