Jan 20 2012

Understanding Technical Writing

Posted by admin in



Technical writing is primarily concerned with communicating scientific, technical, and business information so that readers can understand and use it. It is different than writing fiction or magazine articles, where a mood may be set or–in some cases–where space must be filled and is definitely not the same as creative writing where use of action verbs and colorful adjectives and imagistic metaphors are encouraged.

Put simply, technical writing is the presentation of information on any scientific, engineering or technological topic in the form most suited to its user. Therefore the first rule of technical writing is “know your audience. Too often technical writing is vapid, vacuous, and verbose. In the vast majority of circumstances, technical writing is best done by company personnel who are already well-versed in the products and technology.

This short article outlines what technical writing is, as well as describing some of the things you should do when working on documentation. Technical writing is becoming increasingly dependent on having a specialized business, scientific, or engineering knowledge. Just being an English major or an accurate typist is no longer an option.

Technical writing involves the designing, writing, and organizing documents to deliver clear and consistent technical information and is in high demand especially in industries where competition is fierce and differentiation is the name of the game. It involves a complex combination of skills and the writer must always keep in mind that his or her main purpose in writing at all is to make things –~user friendly’.

When writing documents, this means interviewing or talking to designers, programmers and users. You need to know what the potential user wants to know, and just as importantly, what they don’t want to know.

Every bit of software and hardware needs the support of technical writing in the form of help files and user manuals. Specialist authors of online help systems and software user guides need to understand the users’ needs, where they want to find the information and how they are going to use it.

Many excellent books exist about technical writing and most assume that you can write. But they do tell you how to develop different parts of technical information, such as headings, lists, tables, and indexes.

Writing technical documentation involves a step-by-step procedure of organizing information. Aside from writing ethically, the main goal of technical writing is to convey information precisely and clearly. Researching a topic is essential before you write an article, report, or other material, and technical writing is no different. Therefore, effective technical writing is clear, accurate, and correct. It is a no-ambiguity zone

Dave Odell has been a freelance technical writer for over 20 years and and is now exploring different writing genres and related topics.

http://www.writing.knowhowpages.co.uk
http://www.techauthors.co.uk

eBay Logo  

Online Marketing: A User's Manual, Newlands, Murray 9780470973844 NEW Book


Online Marketing: A User’s Manual, Newlands, Murray 9780470973844 NEW Book


$25.04


Online Marketing: A Users Manual


Online Marketing: A Users Manual


$20.2


  What is SEO anyway? What does affiliate marketing actually mean? Who actually watches corporate videos online?  What’s the difference between a digital brand and a ‘real’ one?…

Quickbooks 2011 (Paperback)


Quickbooks 2011 (Paperback)


$19.35


QuickBooks 2011 has impressive features, like financial and tax reporting, invoicing, payroll, time and mileage tracking, and online banking. So how do you avoid spending more time learning the software than using it? This Missing Manual puts y…

The Internet


The Internet


$18.57


This guide to the internet is intended for beginners and intermediate computer users. From getting online and browsing the web to internet safety, the authors explain topics and related websites for searching; shopping, travel, and finance; entertainme…

Manual to Online Public Records The Rese (Paperback)


Manual to Online Public Records The Rese (Paperback)


$14.63


Shares strategies for using the Internet to conduct research and access online resources, in a guide that provides the public records available for each state, along with advice on evaluating online data for reliability.

The Graphic Designer`s Electronic-media Manual (Paperback)


The Graphic Designer`s Electronic-media Manual (Paperback)


$25.65


This comprehensive resource for graphic designers will help you merge traditional print design skills with new technology to create imaginative, informative, and useful online experiences for clients and ultimately the end users. The Graphic…

Oscommerce Online Merchant 2.3.1 User Manual


Oscommerce Online Merchant 2.3.1 User Manual


$20.12


Oscommerce Online Merchant 2.3.1 User Manual

Online Marketing : A User's Manual


Online Marketing : A User’s Manual


$26.6


No Synopsis Available

Theosophical Manuals


Theosophical Manuals


$10.16


Theosophical Manuals

Seloc Marine Seloc Online, 3 Yr Subscription


Seloc Marine Seloc Online, 3 Yr Subscription


$35.99


Seloc Marine Online, 3 Yr Subscription . Take engine repair into the 21st century, by accessing an electronic database via the internet for up-to-the minute information on your engine. All of the quality and content you ve come to expect from Seloc print manuals is there, plus quick access buttons for Repair, Maintenance Intervals, Spec Charts, and Wiring Diagrams. Information retrieval is easy thru our Quick Access tabs, Explorer-style Table of Contents or a hyper-linked Search Index. We ve also created a growing parts database with thousands of parts offered by Sierra International. And finally, new this year is a dealer/retailer locator database which allows you to search for parts and service providers by zip code. Manufacturers covered include Chrysler, Evinrude, Force, Honda, Johnson, Mercruiser, Mercury/Mariner, OMC, Suzuki, Volvo, Yamaha and Yanmar. SelocOnline is a subscription product that enables the user to access a single mfg/year/model engine for 3 years. SelocOnline Mode

ICD-10-PCS Online 2010 User Guide Version 1.0


ICD-10-PCS Online 2010 User Guide Version 1.0


$143.32


No Synopsis Available

Hipaa Online (User Guide and Access Code)


Hipaa Online (User Guide and Access Code)


$33.05


No Synopsis Available