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.
>My problem is that no one has given me any direction as to what the
>tutorial should do. My initial impulse is to just to make up my own
>sample project and walk users through creating that project using the
>software. Of course, I won't be able to walk users through all the
>features, so I'll probably just do those that are most commonly used.
In general--yes, I'd recommend making up a sample project that is relevant
to the real-world projects users will have. The important thing is to know
Your instinct to cover the commonly used features is also good. I think
tutorials do best when they move a user from the novice stage to an
intermediate user stage. In the tutorial, give them the tools to later move
beyond the intermediate stage -- that is, get them to use the online
During my presentation, we did a case study in which we listed the tasks you
can do with email software like Eudora. The list was pretty long. We crossed
off things that users didn't need to know in order to be intermediate users.
That gave us a task list with a reasonable length.
I prefer to structure tutorials as a series of lessons that show increasing
levels of complexity. Depending on your software, this may build on the same
example or use different examples. Think of the progression as showing the
user how to peel an onion. The first lesson should be relatively short and
give the user a sense that they accomplished a real task with this product.
Subsequent lessons should show more complex features.
Have fun. Feel free to ask more specific questions off-line if you are
uncomfortable posting to the list with your name attached.