"Choose your own" install guide

Chris Vickery cvickery at arenasolutions.com
Tue Nov 6 14:35:28 MST 2007


But if you do that, everyone will start at the Fatal Error message and
work their way back to the beginning!

Honestly, I don't think it's a great idea, because it implies that all
readers start from the same place. Might make indexing difficult too. If
you did it selectively, like for three options within one procedure, I
could see it working out.

Chris "D. Terman" Vickery

-----Original Message-----
From: techwr-l-bounces+cvickery=arenasolutions.com at lists.techwr-l.com
[mailto:techwr-l-bounces+cvickery=arenasolutions.com at lists.techwr-l.com]
On Behalf Of Kevin McGowan
Sent: Tuesday, November 06, 2007 12:27 PM
To: techwr-l at lists.techwr-l.com
Subject: "Choose your own" install guide

Hi folks,

As I'm learning more and more complications about our product install 
process from the professional services people, I am now pondering
rewriting 
my install guide modelled on the old "choose your own adventure" books
from 
my childhood.

Essentially, if you drew it all out in a flow chart, the flow chart
would go 
on for pages and make it seem ridiculously complicated. Instead, I'm 
thinking of a more user-friendly approach...and am wondering if anyone
has 
done this, or might have an opinion on it.

Basically, it would go like this:

You want to install PRODUCT on Windows - go to page 10
You want to install PRODUCT on Linux - go to page 13

In the Windows section:
You want to enable SAS support, go to page 20.
You want to skip SAS support, go to page 21.

Is this madness? Will a reader be annoyed reading a 100-page document
set up 
like this?

Cheers,
Kevin

_________________________________________________________________
Express yourself with free Messenger emoticons. Check out 
freemessengeremoticons.ca

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

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 cvickery at arenasolutions.com.

To unsubscribe send a blank email to 
techwr-l-unsubscribe at lists.techwr-l.com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/cvickery%40arenasolut
ions.com


To subscribe, send a blank email to techwr-l-join at lists.techwr-l.com

Send administrative questions to admin at techwr-l.com. Visit
http://www.techwr-l.com/ for more resources and info.




More information about the TECHWR-L mailing list