Is additional verbiage needed?

Subject: Is additional verbiage needed?
From: "Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 13 Mar 2008 10:11:58 -0700

The applications I document runs on Windows, Linux, and Macintosh
platforms. On the "System Requirements" page, I have only the "System
Requirements" header and ...

Windows
Linux
Macintosh

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.

I am partly inclined to add some introductory verbiage, but I have
resisted since I can't image anything that would add meaning. Having
selected "System Requirements", the user obviously knows what he is
looking for. Similarly, he knows whether he needs to see requirements
for Windows, Linux, or Macintosh. He will also understand hyper linking
conventions (the text is blue, and when hovering, the text is underlined
and the cursor becomes a hand), and if that isn't enough, each phrase is
preceded by a +.

Is more verbiage needed? If so, what could I say that isn't already
(strongly) implied?

Thanks in advance.

Leonard C. Porrello
SoleraTec LLC
www.soleratec.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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:
obtuse message? or obtuse user?: From: McLauchlan, Kevin

Previous by Author: RE: Value of giving up numbering in Word?
Next by Author: RE: is more verbiage needed?
Previous by Thread: obtuse message? or obtuse user?
Next by Thread: RE: Is additional verbiage needed?


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


Sponsored Ads