TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Can anyone point to actual usability research results on
organizing Reference material by task vs alphabetically,
particularly in combination with tutorial material already
organized by task?
<snip>
I can't point to any research in this area. However, you could present it
both ways. The difficulty of doing it depends on your authoring tool(s),
I guess. With HDK, I present an organized TOC that offers everything in
the hierarchy I think works, e.g., organized by task sequence. A click of
a button turns the TOC into an alphabetically sorted list. That
capability is built into HDK. Other tools may have some similar
capability, or you might be able to manage with macros.
Guy Ivie
Follett Campus Resources
GuyI -at- corpmail -dot- follett -dot- com
Gang,
This message is forwarded from a list reader who would
prefer to remain anonymous. Please direct all discussion
TO THE LIST, because I won't be able to forward comments
to said reader.
Thanks!
Eric
***********************************
Colleagues--
I'm preparing a hypertext document about a product. I conceive it as
three chunks:
a tutorial chunk, organized by tasks
an extensive reference chunk, command by command,
with all the details
and a reference summary chunk that just gives the syntax
of each command.
They would be extensivly cross-linked, so that if you
look at the READ command in the summary, you have direct
links to the full reference material about the READ command
and to the tutorial about reading.
Likewise, in the tutorial about COMPUTE there would
be a link to the full reference material for the
ADD command, the SUBTRACT command, and so on.
Now comes the question...I conceive the "extensive reference"
section as encyclopedic (that is, alphabetically organized).
My manager prefers a more task-oriented grouping there AS WELL
as in the tutorial section.
I argue that readers using the reference section know what
they want to look up, and alphabetic organization makes
great sense. My fallback is, of course, that the reference
summary would naturally be alphabetical, and the reader COULD
gain access to the full reference for BABBLE by finding
BABBLE alphabetically in the summary and following the link.
Can anyone point to actual usability research results on
organizing Reference material by task vs alphabetically,
particularly in combination with tutorial material already
organized by task?
-----
**************************************************
Eric J. Ray ejray -at- raycomm -dot- com
TECHWR-L Listowner http://www.raycomm.com/
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html
