TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
1) Documentation that uses real industry terms and properly and eloquently defines them so everyone then understands what these terms mean and can apply them to your product and outside the contect of your deliverable.
2) Documentation that skirts around the use of real industry terms in order to convey information to a captive audience who can apply their knowledge from the documentation only to the deliverable.
I vote for #1. Why?
Your audience will be better off in the long run knowing the correct terminology. Should at some point they buy an additional product to use in their jobs that uses the same terminology, they can draw associations easily and not get confused. Otherwise they could look at "upload" in one document and "FromHandheld" in another, and perhaps "korlsomfgam" in another and puzzle over whether these are indeed the same or not. In that case, your skirting around the standard terminology just confused them, which is what you were trying to avoid, right?
Also, if you are using custom terminology for standard terms, you now have "reverse education" happening, where you need to educate everyone working on YOUR team from this point forward on what these terms actually mean and refer to, and you have to make sure they are all being used consistently by everyone, thus potentially confusing YOUR team.
And furthermore, you can create a section in your very first chapter to define these terms and other concepts that will be used throughout the documentation, and then you can reuse this section in every publication you produce.
Of course you also have to consider audience members who DO know a thing or two... How will they react to seeing something they know and understand as "upload" being refered to as FromHandleld or korlsomfgam? Wouldn't you think that would be confusing for them, YOUR POWER USERS? These are the people who should be able to pick up the product and easily master it, and teach others to use it properly. You certainly do not want to confuse THEM!
Teach them the right way, which is why I suggested you properly define the standard terminology and use it. Everyone wins.
You can assume your audience is "stupid", but you don't necessarily need to nurture that assumption. That itself, IMHO, is "stupid".
SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo
>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more. http://www.doctohelp.com
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.