Re: Nitpicky little style question

Subject: Re: Nitpicky little style question
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 13 Dec 2006 06:51:58 +1100

Milan Davidovic wrote:

--- Beth Agnew <Beth -dot- Agnew -at- senecac -dot- on -dot- ca> wrote:
Well, I'm a little tired of the World According to
Microsoft... Why not
figure out a style that works for your user base,
whether it conforms to
Microsoft or not?

Good point, but I think in this case Microsoft also
has a good point. Why say "Click the Landscape radio
button" (in the Page Setup dialog box) when "Click
Landscape" would work just as well?


We try to avoid referring to the type of element
when the GUI is clear so we would just say "Select
Landscape" (or add more detail about the selection:
"Select Landscape as the page orientation"). Unless
potential confusion exists due to multiple GUI
elements with the same name, we try to emphasize
the result rather than the interface.

-- Janice

***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
RE: Nitpicky little style question: From: Milan Davidovic

Previous by Author: Re: Tables inside numbered lists
Next by Author: Re: Non-English tech writer
Previous by Thread: Re: Nitpicky little style question
Next by Thread: Re: Nitpicky little style question


What this post helpful? Share it with friends and colleagues:


Sponsored Ads