RE: Business Process Information in a User Guide

Subject: RE: Business Process Information in a User Guide
From: "Damien Braniff" <dbraniff -at- amphion -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 4 Sep 2001 15:09:16 +0100

This is a part of an ongoing debate about just how much information we provide. Are the users interested in the why and whatfor or are they only interested in the how. It very much depends on exactly what it is you're documenting - know your audience again. When I've done online help, I've tended to make it procedure based - the how to approach, working on the principle (and customer feedback) that when the user resorts to help it's because they're stuck and want to know how to do something. We have also included links to background topics (the why etc) for anyone who is looking for that.

In other projects we've used a flowchart approach with each block in the chart representing a stage in the process. Each procedure has the relevant step in the flowchart highlighted and a reference to where in the manual background information can be found.

Damien Braniff
Technical Writer
Amphion Semiconductor Ltd.
50/51 Malone Road
BT9 5BS Belfast, Antrim
Northern Ireland

Tel: 028 9050 4000
Fax: 028 9050 4001
E-mail: dbraniff -at- amphion -dot- com
Web: www.amphion.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/

+++ Miramo -- Database/XML publishing automation. See us at +++
+++ Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion +++
+++ More info: http://www.axialinfo.com http://www.miramo.com +++

---
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.


Previous by Author: named destinations from\for bookmarks
Next by Author: RE: Baiting for the single source rant
Previous by Thread: RE: Business Process Information in a User Guide
Next by Thread: RE: Business Process Information in a User Guide


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


Sponsored Ads