User's guide for Web applications

Subject: User's guide for Web applications
From: Laura Varteressian <LVarteressian -at- FinancialEngines -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 27 Aug 2001 13:43:18 -0700

Do any of you write for a Web-based application? If so, maybe you can help
answer some questions we have about creating a user's guide for a Web
application.

The technical writers here have been asked to create a user's guide in PDF
to be distributed to the end users of a new Web app. We expect users to
download the PDF from the Web site and search (and perhaps print) the
document for answers to their questions. There is no plan for online help
for the application, so all users questions need to be answered within the
application itself or in the PDF.

Although we have extensive experience creating user's guides for
Windows-based apps, we're new to creating a similar document for a Web-based
app. (In fact, I even question the need for one, but that's a fight I'm not
going to win.)

Have any of you dealt with the following questions, and if so, how?

How much information did you include in the application itself and in the
user's guide? Did you find that some information had to be repeated in both
media or were you able to make a clear distinction as to what goes in the
app and what goes in the doc?
What level of detail did you go to in the user's guide? We're thinking that
our users require a broad overview of the application, but not step-by-step,
"click here," "type your name" details.
How often do you update the PDF? Do you inform users of changes to the
user's guide, and if so, how?
Do you include screenshots of actual Web pages in the user's guide? If so,
do you encounter difficulties in keeping the PDF current?
Have you gotten any user feedback about the user's guide that you've found
helpful?

I'd appreciate any information you care to share about your experience in
this area.

Thanks in advance,

Laura Varteressian
Sr. Technical Writer/Editor
Financial Engines
Financial Engines - the power to shape the future(tm)



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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Re: Acronyms on the list (answer to perplexing riddle)
Next by Author: Re: How about SME (Was FAQ thread)
Previous by Thread: RE: Questions about FAQs; FAQ tools
Next by Thread: RE: User's guide for Web applications


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


Sponsored Ads