Book Image

User Training for Busy Programmers

By : William Rice, William Rice
Book Image

User Training for Busy Programmers

By: William Rice, William Rice

Overview of this book

If you need to write a successful software training course and are unsure of how to start, then this book gets right to the point with clear, concise directions for developing an end-user software course. This step-by-step job aid walks you through the process of developing a successful, instructor-led software class. There are many good books on training theory. This book takes a more practical, condensed approach for when you don't have time to learn training theory. It is based on fifteen years of technical writing and training experience. In under 100 pages, the book guides you through the process of developing an end-user software course using a method that is tested, proven, and based upon sound instructional theory.
Table of Contents (13 chapters)

The Checklist


The checklist below is your map for creating the course. It is organized into short tasks. Each task is covered in a chapter of this book. If there are any supporting materials for that task, the section also points to those materials.

Copy the checklist, put it where you can see it, and start working your way through it.

Step 1: The Setup

The Setup involves making high-level decisions about your training course’s goals and how to achieve them. Essential to this is obtaining the support of course sponsors.

  • Who needs to be trained Arrive at a consensus about who needs to be trained and what kind of training they need.

  • Learning objectives Develop specific, measurable objectives for the course.

  • Need for a training class Determine if there is need that a training class can or should fulfill and that a training course is the right solution, or if mentoring, informal demos, or self-study would better meet the learners’ needs.

  • Training scenario simulating business situation Determine what scenario will give your students the most realistic experience in the classroom. Decide upon a training scenario that effectively simulates the real world in the class.

  • Learning objective exercises For each learning objective, write a paragraph describing one or more exercises to practice that objective.

Set Criteria and Get Buy-In

  • Set the criteria for success Decide how you will prove that the students have mastered each objective: by passing a written test, performing the process in front of an instructor, performing the process on the job, and so on.

  • Get buy-in from sponsors Present the audience, outcomes, scenarios, exercises, and measurements of success to the stakeholders for their agreement.

Step 2: Develop In-class Exercises

Practical exercises are central to your course. Developing them first, and then building the course around them, is the quickest and most effective way to develop your course.

  • Prepare software for the exercises Prepare the data files and application settings for class. Take a snapshot of the files and application so that you can duplicate the environment for your students.

  • Write the directions Step through and write directions for each of the exercises. Save a snapshot of the training files after each exercise.

  • Revise the directions Go through the directions and make sure that the following points are taken into account:

    • Sentence structure: Put conditional phrases first

    • Start each numbered step with an action

    • State the result of each action

    • Use the second person

    • Differentiate button pushes, menu items, and text that is displayed on screen

    • Separate nested menu items

Test and Revise Exercise Files

  • Return the training files and development workstation to its pre-class condition Return the training software environment to the condition it was in before you started writing the exercises. This includes the training application, data files, and any supporting applications and files.

  • Step through the exercise directions Step through the exercise from start to finish exactly as the students will in class.

Step 3: Develop Lectures

Next, we develop illustrated lectures to introduce each exercise. Gradually the course is taking shape…

  • Develop a slide show for each unit in the course Use the following list of slides as a guideline:

    • Unit Title

    • Purpose

    • When is this procedure performed?

    • Who performs this procedure?

    • What information is entered during this procedure?

    • What processing does the system perform on the data entered during this procedure?

    • What is the result of this procedure?

    • Special Fields

    • Demonstration

    • Exercise

    • Review

    • Questions?

Step 4: Develop the Demo

Most students will learn a lot by watching you perform actions. Develop demos that will give students the knowledge to perform your carefully chosen exercises.

  • Identify the core functionality that the students must know to complete the exercise successfully.

  • Write the demo directions and speaking points.

  • Remove steps that use any menu items or functions that the students do not need to know.

  • Consider adding optional functionality that you think will enhance the demo.

  • Make a copy of the step-by-step directions for the exercise. Use this as the starting point for the demo.

  • Change the data in the copy so that the demo uses different data from that in the exercise.

The result should be a two-column document for each unit, with step-by-step directions in one column and speaking notes in the other.

Step 5: Package the Course

Packaging the course by including handouts and notes gives it a more lasting value:

  • A Student Guide means that students can refer back to course notes long after the course is over

  • An Instructor Guide means that even other instructors and not just you, can deliver your course to students

The Student Guide

The following five components will remind your students of the course’s key points, and where to get more help if they need it.

  • Write the Introduction Cover the following points in the introduction:

    • State the goals of the course

    • Describe the intended audience

    • List prerequisites

    • State the duration and class size

    • Include training group contact information

  • Printouts of the slides Generate handouts, with several slides per page and space reserved for taking notes.

  • Directions for in-class exercises Print out each exercise and place it after the appropriate slide show.

  • Resources and contacts Include links to online help, where to obtain documentation for the software, and contact information for people who can assist the students.

The Instructor Guide

This consists of the same five parts as the Student Guide, and adds information to each of the parts. Start with a copy of the Student Guide and add the information below.

  • Table of Contents In addition to a table of contents, generate a table of the units and their learning objectives.

  • Introduction Add login information for any accounts used in the class. This includes the account for the instructor, the students, and any administrative accounts needed to set up the system.

  • Printouts of the slides Print a copy of the slides and speaking notes for the Instructor Guide.

  • Directions for the in-class exercises For each unit, place the directions for the demonstration between the slide show and the exercise.

  • Resources and contacts

  • Slide-show files Export the slide show in a format that will work on the classroom’s instructor computer.

Step 6: Set Up and Test Run

Before delivering the course for real, it’s important to test the material and practice your delivery. Try to do as many of the tasks below as possible. A full run-through may not be always possible, but if you have the time, it will help.

Test the Room Setup

  • Run the course software on the training room computers.

  • Test the projector.

  • Test Internet access.

  • If the course requires Web access, test and ensure firewall and security settings do not interfere.

Practice Run

  • Deliver the course to a small test group or an empty room. Step through the exercises and demos in the order they will be given.

Revise the Course

  • Edit the course material based on feedback from your practice run.

Develop Follow-up Materials

  • Develop the tools needed to measure the criteria for success. Get the sponsors’ buy-in on the method or methods used.

Step 7: Deliver the Course

This last step is the practical implementation of all your above preparation. Make the most of your hard work, avoid embarrassing moments, and present a successful course by following the points mentioned below:

  • Keep the tone consultative.

  • Follow up unanswered questions.

  • Avoid unexplored territory.

  • Encourage students to watch and then do.