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.
Subject:RE: Nitpicky little style question From:Beth Agnew <Beth -dot- Agnew -at- senecac -dot- on -dot- ca> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Tue, 12 Dec 2006 12:09:34 -0800
Well, I'm a little tired of the World According to Microsoft. The level of
computer literacy is rising all the time, and users are intelligent enough
to learn the proper technical terms for things. Microsoft seems to want to
dictate how we will use our computers. Here's a renegade thought: Why not
figure out a style that works for your user base, whether it conforms to
Microsoft or not?
-----Original Message-----
From: techwr-l-bounces+beth -dot- agnew=senecac -dot- on -dot- ca -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+beth -dot- agnew=senecac -dot- on -dot- ca -at- lists -dot- techwr-l -dot- com]On
Behalf Of Jim Shaeffer
Sent: Tuesday, December 12, 2006 7:22 AM
To: Al Geist; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Nitpicky little style question
Also according to Microsoft, in user documents, avoid the technical
names of interface elements and just use "select" or "click" whatever.
Focus on the task and the names of the parameters or settings being
selected, not the interface elements.
In developer documentation, use the proper technical terms for your
development environment.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-