Technical Writers Training

The profession of technical writing is no more an isolated domain of west. The past decades have ushered the emerging numbers of technical writers in India too. To those who have not come across this profession or this opportunity, technical writing is the art and science of writing about the technical subjects to help end users of the technology.

Most often the requirement of becoming a technical writers demands advanced knowledge of English writing. In fact the good knowledge of English writing holds good to comprehend complex technical knowledge into simple English writing that helps user to understand the technology. But don’t get misguided that to be a technical writer you need to have prior experience of journalism or mass communication or a post graduate degree in English. If you have flare for writing in English and if you can write simple and crisp English, you are in the league. However, if you are transitioning from Journalism or have a post graduate degree in English, you will have an edge. Yet again, I would say that writing is more of an art than science and it can be anyone’s passion.

Today, the opportunity in the market requires you to be good in English. Many companies would prefer you to be on-board and train you in the technical writing on job. Most others would like to have a person who has some exposure of technical writing and knowledge of styles and tools of the trade.

The technical writing training offered by different institutes in different parts of the country exposes you on the knowledge of the following:

• Different style guides of technical writing
• User guide authoring and publishing tools
• Help authoring and editing tools
• Image editing and designing tools
• Classroom sessions on procedure and instruction writing
• A glimpse of different kinds of documents written by a technical writer
• The different technological domain in which technical writers are getting employed
• Creating a sample documents  

The training institutes are meant to teach technical writing and not English writing. You will be disappointed if you think that they can teach you technical writing without you knowing English writing. However, you can complement your average level of writing skills with the expert level of authoring tool knowledge which often required in trouble shooting and that makes you a production specialist.

If you have good skills of writing and preliminary knowledge of authoring tool, getting a job as a technical writer will not be tough. Today, almost all the industry driven by technology requires technical writers into their fold. Being a trained technical writer would greatly enhance your chances of getting a job.

Redundancy in User Documentation

End user documentation in software industry, to me, sometimes looks redundant. I have had the opportunity to work in few of the software companies which develop software application. As a part of the end user documentation, following documents are prepared to ship with the application:

• Release Notes

• Installation

• User Guide

• Web-Help

• Admin Guide

• Tutorials

The release notes specify different features and version of the software in the particular release, whereas the installation guide describes about the system requirements and stepwise installation procedures of the Software. Sometimes, it discusses about the architecture of the software too, for the better understanding of its compatibility with hardware and other software for operational efficiency. These are the useful information contained in these documents.

Admin guide is another document which takes you through the functionality and features that helps in administering the software. Sometimes, you, as an end user can act as an admin too. In another cases, like in enterprises solution software, there are different individuals who would be responsible for acting as admin.

WebHelp is another documents prepared as one of the applications, to be integrated with the software which comes handy to understand the functionality of the software. The content created with this application contains various web pages linked with hyperlinks with each other and can be navigated through a table of contents. In this, the contents are created keeping in mind the task based approach. Even the particular windows of the software can be linked with particular web pages which are called context sensitive. This entire application is integrated with Help menu of the top menu bar of the home page of the software.

Ideally, the user guides are created to take a walk-through of the software with the minute details. The approach is to focus on every bits and pieces of information about the structure and functionality of the software. However, some of the information contained herein are already discussed in the WebHelp. The tutorial again has the mixed contents of WebHelp and user guide.

Therefore, user guide, WebHelp and tutorials contain approximately 50-60% of similar contents. Some of the software application has exactly the same content in user guide as well as in WebHelp. Only the format of display is different. In industry, it is called single sourcing. The idea is to write once and display in different formats.

Can we call it as effective documentation? In my opinion, certainly not! Because end user find almost redundant contents in these document. The time is come to realize this and give the user the documents which is useful for them. Otherwise, tradition will continue as it is said that a user never reads or consult the documents shipped to them along with the software.

Truly, if user does not find the answers he is looking into the document then definitely he would never consult them. This throws open a question on our credibility of being a technical writer asking whether we are doing our job keeping user in mind or not. This also shows that we are writing a document which is not useful for the users. Well, are we only fulfilling a regulatory requirement or ready to help users?

Remember, being a technical writer we are also a user of the documents that we refer in day today life while working with different software applications. Incidentally, how do you feel when some of your questions does not fetch you answer from the integrated help or user guide on that product? You feel even disappointed when the topic is there but if it is not well explain to guide you to complete a task. You definitely blame the technical writers for sloppy job done. This is a great feedback for you to be self motivated to treat your user valuable and think of the documents which will help them. But not load them with unnecessary documents, which will make them dump these without even looking at them.

So, be creative and use your wisdom.