Where's the beginning?

Subject: Where's the beginning?
From: "Caroline Tabach" <Caroline -at- radcom -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 22 Nov 2006 11:06:39 +0200

I try to make the defaulot page that the help opens to (which is not necessarily the first page in the browse sequence)
be the overview of running the application:
Message: 29
Date: Tue, 21 Nov 2006 11:07:37 -0500
From: mlist -at- safenet-inc -dot- com
Subject: Where's the beginning? (was RE: When to Spell Out Acronyms)
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <88484FCE42800C499ED8254F9F5E35EF048ACEF6 -at- EXCHCA1>
Content-Type: text/plain; charset="ISO-8859-1"

This, of course, got me to wondering what's the best approach
in Help.

We've pretty much been dropping paper and PDF documents in
favor of Help. Mostly WebHelp.

So, where's the beginning of Help?

I've already got contending demands to have my WebHelp
start page be:

a) the disclaimer, acknowlegement and copyright page

b) an intro page for product configuration (my preference)

c) various other bright ideas.

Since I can only really have one "Start" page, I can't accomodate everyone.

I _could_ spell out acronyms in hidden-til-you-click dynamic html
expanding or drop-down text... but since a person can enter Help
at any point, that would mean putting expansions behind (under? around?)
virtually every occurrence of an acronym. That would make my Help
pages even patchier than they are now. Eek!

As well, I already make liberal use of expanding or drop-down text
for asides, non-essential examples, good-to-know stuff, etc., and
I don't wish to "devalue" those links by crowding them among
thousands of repetitive expanded acronyms.

What do others do?


The information contained in this electronic mail transmission may be privileged and confidential, and therefore, protected from disclosure. If you have received this communication in error, please notify us immediately by replying to this message and deleting it from your computer without copying or disclosing it.


Caroline Tabach
Technical/Marcom Writer

Fax:         +972 3 6474681
Email:   caroline -at- radcom -dot- com


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

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at 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.

Previous by Author: RE: Evaluating Candidates Using Tests, Logic Questions, and
Next by Author: Linux
Previous by Thread: Re: RANT: Marketing!!!
Next by Thread: Linux

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

Sponsored Ads