RE: "Choose your own" install guide

Subject: RE: "Choose your own" install guide
From: "Chris Vickery" <cvickery -at- arenasolutions -dot- com>
To: "Kevin McGowan" <thatguy_80 -at- hotmail -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 6 Nov 2007 13:35:28 -0800

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 -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Kevin McGowan
Sent: Tuesday, November 06, 2007 12:27 PM
To: techwr-l -at- lists -dot- techwr-l -dot- 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 -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/cvickery%40arenasolut
ions.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.


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

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.


References:
"Choose your own" install guide: From: Kevin McGowan

Previous by Author: Certifications in the IT industry
Next by Author: RE: suffix in or suffix to (a name)?
Previous by Thread: Re: "Choose your own" install guide
Next by Thread: RE: "Choose your own" install guide


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


Sponsored Ads