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


Online Marketing: A User’s Manual Newlands, Murray


$32.05


Online Marketing: A User's Manual 9780470973844 NEW


Online Marketing: A User’s Manual 9780470973844 NEW


$23.06


Online Marketing: A Users Manual


Online Marketing: A Users Manual


$20.6


  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?…

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…

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…

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.

Chevrolet Inline Six-Cylinder Power Manual (Paperback)


Chevrolet Inline Six-Cylinder Power Manual (Paperback)


$19.57


However you plan your modification, from mild to wild, you will find thought provoking insider information that will help you achieve your horsepower goals. Use the inline six`s inherent advantages to beat the competition. Discover modificati…

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


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


$23.22


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…

Online Marketing: A User's Manual


Online Marketing: A User’s Manual


$18.99


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? The internet has changed how most people do their jobs beyond recognition. Sometimes that’s quite exciting, and other times it’s pretty frightening. Online Marketing: A Users Manual has all the answers. Murray Newlands, an international expert on making the most of online marketing, tells you the basics behind the key aspects of online marketing, how you can use it, how you can use it even better, and looks at what the future might hold. With this book you’ll make more money, impress your colleagues, know your customers more and, best of all, never nod with that confused expression on your face again.

Writing and Designing Manuals and Warnings


Writing and Designing Manuals and Warnings


$96.94


Twenty-five years ago, how many people were thinking about the internet on a daily basis? Now you can find everything, including technical and instruction manuals, online. But some things never change. Users still need instructions and warnings to guide them in the safe and proper use of products. Good design, clear instructions and warnings, placement of graphics, all the traditional elements hold true whether designing for print or online materials. And technical writers still need those two most valuable commodities-time and information-to do their jobs well. Another constant, Writing and Designing Manuals and Warnings, now in its fourth edition, offers real-world guidance based on real-world know-how for the development of product documentation. See What’s New in the Fourth Edition: New organization to clarify the principles of manual and warning development Coverage of the digital revolution and the global marketplace Expanded section on product safety and warnings Information on international standards for warnings Backed by Research and Collective Experience Drawn from the collective experience of hundreds of technical writers, graphic artists, and product safety engineers, along with the author’s nearly 30 years of experience helping companies improve instructions and warnings, this how-to book covers every aspect of developing state-of-the-art product manuals and safety warnings. Filled with examples that show how good manuals and effective warnings can add value to your company’s products and build repeat business, while at the same time reducing liability exposure, the text demonstrates how to create manuals that give products a competitive edge and improve customer satisfaction. Solidly grounded in research, but not a stuffy academic treatise, this down-to-earth, practical book is a survival guide for writers in the real world of short deadlines and tight budgets.

Project Planning for Writing Software Manuals


Project Planning for Writing Software Manuals


$17.49


Both Project Managers and Technical Writers benefit from a well-documented template and style guide. The planning process for a user manual ensures that once the writing begins, everyone is working toward an common goal.This book is for both the Project Manager and the novice Technical Writer. It provides guidelines for creating standards for developing User Manuals and other Technical Writing Projects.

Smashing Ux Design - Foundations for Designing Online User Experiences


Smashing Ux Design – Foundations for Designing Online User Experiences


$38.24


Smashing Ux Design – Foundations for Designing Online User Experiences

User Participation Simulation for Online Communities


User Participation Simulation for Online Communities


$76.05


No Synopsis Available

Web 2.0: User-Generated Content in Online Communities


Web 2.0: User-Generated Content in Online Communities


$55.47


Hauptbeschreibung The number of Internet users is steadily growing. Currently, 55% of all Germans go online on a regular basis compared to 28% in 2001 – and there is no end in sight to this upward trend. Today’s young people are growing up with the Internet and the Internet is growing up with them. It is evolving: the term for what is happening now in cyberspace is “Web 2.0″, an expression coined at a conference in 2004 by the web-business mogul Tim O’Reilly, to describe a new evolutionary phase of the Internet. The phrase is shorthand for the second Internet boom, which now follows the one that ended in late 2001 with the biggest destruction of investors’ capital in history. The bursting of the so-called dotcom bubble 6 years ago marked a turning point for the web. At that time, many people concluded that the Internet was over-hyped. Bubbles and the subsequent shakeouts, however, appear to be a common feature of all technological revolutions. They have always marked the point at which real success stories developed their full scope and showed their strength. The defining feature of the current evolutionary phase of the web is that established companies are giving huge amounts of money to start-ups which have three things in common: they have grown from nowhere with astonishing speed; they often have no revenue stream to speak of; and most of their content is produced by their users. Google paid $1.65bn for the acquisition of Youtube, Rupert Murdochs’s News Corp. bought Myspace for $ 580m, and Holzbrinck fully took over Studivz.net for about ? 85m, to give just a few examples of recent “Web 2.0 deals”. What makes these so-called online communities so valuable? The answer to this question may be surprising: The deployed technologies are more or less the same as 6 years ago, but what all these new sites share is a new approach to creating things: “user-generated content”, in the jargon. The Internet is no longer about corporations telling users what to do, think or buy; it is about the content people create themselves. Participation, not publishing, is the keyword. This development is particularly interesting for corporations which have noticed the importance and potential of the “do-it-yourself Web” as both a strategic marketing tool and a source of valuable information about consumer preferences and opinions. Tomorrow’s consumers will no longer be interested in what companies say about their products and services, they will rely on opinions of other “normal” people. Chris Anderson, chief editor of Wired Magazine, states: “Your brand is what Google says about it. Not what you say about it”. Corporations which have spent huge amounts of money on questionable market research projects in the past can get even better information for free in the future, as consumers and interested users exchange experiences and opinions about brands and products in online discussion forums anyway. As a result, marketing activities and product off