Re: New Way to do TOC

Subject: Re: New Way to do TOC
From: "Pro TechWriter" <pro -dot- techwriter -at- gmail -dot- com>
To: "Barbara Vega" <BarbaraV -at- libertyims -dot- com>
Date: Wed, 13 Feb 2008 16:04:39 -0600

Hi Barbara:

I guess it depends on how the users will want to use the material. Will they
be looking up a reference? Or solving a problem, or getting education about
a topic? Is the material oriented to different roles within an organization?
Specific to areas or disciplines? Or task specific?

Usually I start there: What does the user need to do? For my last position,
the policies and procedures were accessed under different conditions, by
different roles, and for different reasons. Some topics changed infrequently
(state regulations), and others had up-to-the-minute changes (federal
disaster area declarations). Some topics were organizational and not
germain to everyone.

To give an example, there were "entry paths" in the TOC that were related to
each state (Arizona, California, etc.), and then another path for "Disaster
declarations." These both made use of the same content, but the user didn't
need to know that. There was only one copy of each topic, but it was
referenced in two places (or more, depending).

The TOC also had entry paths by role and department, because a loan officer
and an underwriter don't always need the same information, because their
jobs are different. Where a topic intersected, or was needed in both places,
it was linked to, and displayed in, both places.

It's nice to look at an information access schema that someone else uses as
a starting point, but the most important thing to know is how *your* users
will want to access the data. Its' good that you are asking the question.

The top-down, general-to-specific approach, IMHO, is great for reference
material like dictionaries, or leisurely learning a task that is broken down
from a general overview to steps, but this may not work for other
applications. It would drive me nuts if I need to know (right now) what the
steps are to enter and report on some thing or another. I would want the
steps, period, so I could get on with my day.

I hope this helps :-)
On Feb 13, 2008 1:06 PM, Barbara Vega <BarbaraV -at- libertyims -dot- com> wrote:

> Hello All
>
> We are looking at a new way to do our TOC
>
> We use Flare BTW. (That has little/nothing to do with post).
>
> At any rate, my boss is a fan of the way MSDN does theirs. On MSDNs, you
> start at a high level for the first topic, which has a "+" sign to the
> left, You can click on the "+" signs and drill down to successively
> lower topics to get to the "ground floor: topic. Depending on the topic
> being discussed, there are varying ways of presenting the material; you
> may have links of topics, you may have tables, or charts, or white
> papers, etc.
>
> It is, as you may expect, quite dense.
>
> My feeling is it is too dense, and a bit overkill for our software, even
> though our software is very complex (knowledge base information
> management software)
>
> Anyway - you can check out msdn's software at the library section of
> their site at http://msdn2.microsoft.com/en-us/library/default.aspxthe
> - the left hand side of the page
>
> Can you point me to other types of - perhaps similar tocs but not quite
> so dense that I can take a look at? I know Microsoft was doing something
> with Vista then bagged it and then - I can't remember - and I am out of
> the loop -
>
> Thanks
>
>
> Barbara Vega
> Documentation Department
> Liberty IMS
> Costa Mesa, CA
>
>
> "This message is for the named person's use only. It may contain
> confidential, proprietary
> or legally privileged information. No confidentiality or privilege is
> waived or lost by any
> mistransmission. If you receive this message in error, please immediately
> delete it and all
> copies of it from your system, destroy any hard copies of it and notify
> the sender. You must
> not, directly or indirectly, use, disclose, distribute, print, or copy any
> part of this
> message if you are not the intended recipient.
>
> If you receive this communication in error, please notify us immediately
> by telephone (collect)
> at (714) 751-6900 and return the original message to us at the above
> listed address via electronic
> mail. We will reimburse you for telephone expenses involved. Thank you."
>
> ------------------------------------------------------------------------
>
> Scanning of this message and addition of this footer is performed by
> SurfControl Email Filter
> software in conjunction with McAffee virus detection software.
>
>
>
>
>
>
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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<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 pro -dot- techwriter -at- gmail -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/pro.techwriter%40gmail.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.
>
>


--
"Life is short, but there is always time enough for courtesy."
- Ralph Waldo Emerson
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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:
RE: Software project documents - Jim Barrow: From: Melanie Blank
Software project documents - Location: From: Paul Hanson
New Way to do TOC: From: Barbara Vega

Previous by Author: OT HELP REQUEST? Anyone Work for Vignette?
Next by Author: Re: Need printer suggestions
Previous by Thread: New Way to do TOC
Next by Thread: Re: Software project documents - Location


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


Sponsored Ads