RE: is more verbiage needed?

Subject: RE: is more verbiage needed?
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Karen Mulholland" <kemulholland -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 14 Mar 2008 08:59:28 -0600

Karen Mulholland wrote:

> I also prefer the minimalist approach, but in this case each
> line requires one more element: the version or range of
> versions on which the application is known to work properly.
>
> There are bound to be people out there is still running
> ancient, creaking versions of these operating systems, and
> some of them may be your customers. Is your product going to
> work on Windows 95? Probably not.

Karen, you stopped reading Leonard's description too soon. True, the
"System Requirements" page initially contains only:

Windows
Linux
Macintosh

_But_ read on:

> Except for the header, each phrase is a hyperlink that expands a table

> containing the application's OS, hardware, and software requirements
> for each platform.

Those three OS names are merely the gateway to details regarding that
platform (including OS requirements). A single hyperlinked word for each
platform entirely serves the purpose.

"It's my opinion and it's very true." ;-)

Richard


------
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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%40web.techwr-l.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/ for more resources and info.


Follow-Ups:

References:
Re: is more verbiage needed?: From: Karen Mulholland

Previous by Author: RE: Is additional verbiage needed?
Next by Author: RE: Is vs. Are
Previous by Thread: Re: is more verbiage needed?
Next by Thread: RE: is more verbiage needed?


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


Sponsored Ads