|
Review Sheet for Drafts of Tutorials
The premise for these criteria is that the writer has done a
review and submitted the review and the draft to the instructor for evaluation.
The criteria focus on the review materials the student prepared, and also some
points about the draft of the tutorial.
Professionalism
- Questions in the review letter pertain to real issues in the tutorial as opposed
to superficial issues.
- Shows an awareness of reviews as a meaningful activity: how productive is the review?
How could
it be more productive?
- Incomplete drafts can cause a weak review…
- Scenario: avoid
disconnecting from the reader once the tutorial starts.
- Avoid the tutorial in isolation: what about people skills?
- Acknowledge the "implicit" scenario of workplace activity
that lies behind the lesson.
How to write a step…
Avoid making each tiny event a step.
Instead of
-
Place your cursor over the Start button
-
Press down on the cursor
-
Select All Programs
-
Move the cursor to the PageMaker program... (etc)
Just say:
-
Select All Programs, Adobe, PageMaker from the Start menu
or
-
Choose Open from the File menu
Avoid steps with no explanation
Example (weak):
-
Click "Yes"
-
Click "Next"
-
Type "150"
-
Check the box that appears
-
Click "Yes" again
-
Click "Okay"
Such a procedure is demeaning to the user. Explain what
goes on with each step; acknowledge the thinking process at work.
Example (better):
-
Click "Yes" to affirm your desire to start the Wizard
-
Click "Next" to proceed to the next stage.
-
Type "150" to specify the size of the figure (about 3
inches)...etc.
Teach vocabulary explicitly
Examples of using just the right word:
- "musical
document" = "score"
- "cut out" = "crop"
- "fill" and "stroke"
- "click" versus "select"
Chunks: Here are some chunk types.
| 
