The Four Components of a Procedure

H. vanderMeij University of Twente ; M. Gellevij

Abstract

Background. As they guide people in performing a task, procedures are the heart of most manuals. It is, therefore, somewhat surprising that the theoretical and empirical knowledge of their nature has remained somewhat elusive. This paper describes a theoretical framework for procedures, summarized as the four components model, which is grounded in systems theory and rhetoric. Aim. The study addresses two research questions: (1) What are procedures made of? and (2) Which design guidelines for procedures can be abstracted from theory and research? Results. The model distinguishes between: goals, prerequisite states, unwanted states (warnings and problem-solving information), and actions and reactions. For each component pertinent research findings are summarized and lead to the formulation of design guidelines. Occasionally these guidelines are compared with existing procedures from a sample of 104 manuals to see how well theory and practice agree. Conclusion. The model offers a manageable and expandable framework for creating user support that is based on scientific research. It can be used for a systematic analysis of procedures and for their (re)design.

Journal
IEEE Transactions on Professional Communication
Published
2004-03-01
DOI
10.1109/tpc.2004.824292
CompPile
Open Access
Closed
Topics
Export

Citation Context

Cited by in this index (4)

  1. IEEE Transactions on Professional Communication
  2. Technical Communication Quarterly
  3. IEEE Transactions on Professional Communication
  4. IEEE Transactions on Professional Communication

References (50) · 4 in this index

  1. Codeboek voor het analyzeren van procedures in software—en hardware handleidingen
  2. The logical and rhetorical construction of procedural discourse
    Tech. Commun.
  3. IEEE Transactions on Professional Communication
  4. 10.7551/mitpress/4616.003.0004
  5. 10.1046/j.1365-2729.2000.00147.x
Show all 50 →
  1. Instructional Design
  2. The Essential Office 2000 Book
  3. 10.1145/365024.365107
  4. 10.1109/AUIC.2001.906281
  5. 10.1145/223904.223914
  6. Screen captures in software documentation
    Tech. Commun.
  7. Designing instruction for constructivist learning
  8. 10.1037/0022-0663.82.4.715
  9. 10.1080/00220970209599507
  10. IEEE Transactions on Professional Communication
  11. Visuals in Instruction: Functions of Screen Captures in Software Manuals
  12. 10.1016/S0022-5371(82)90456-X
  13. 10.1037/0278-7393.13.1.18
  14. Components of Technical Writing
  15. Journal of Technical Writing and Communication
  16. How to Communicate Technical Information. A Handbook of Software and Hardware Documentation
  17. Designing for the real world: Using research to turn a target audience into real people
    Tech. Commun.
  18. Writing, text, and the reader
  19. 10.1037/0022-0663.78.4.263
  20. Z535.1-5
  21. Deutsches Institut für Normung, Benutzerinformation. Hinweise für die Erstellung
  22. Int. Org. Standard.
  23. Int. Org. Standard.
  24. 10.1201/9780203983836.ch2
  25. 10.1177/001872089403600309
  26. 10.1177/001872088803000411
  27. 10.1177/154193128603000723
  28. Produktinformatie ter preventie van ongevallen in de privésfeer. Gevaars-en veilighiedsin…
  29. Attention capture and maintenance
  30. 10.1201/9780203983836.ch8
  31. Int. Org. Standard.
  32. Wanneer waarschuwen waarschuwingen?
    [When do Warnings Warn?] Taalbeheersing
  33. Factors influencing the effectiveness of warnings
  34. 10.1201/9780203736166
  35. 10.1177/001872088402600402
  36. Minimalist computer documentation. A study on constructive and corrective skills development
  37. 10.1006/ijhc.1995.1009
  38. IEEE Transactions on Professional Communication
  39. 10.7551/mitpress/4616.003.0003
  40. Interface metaphors and user interface design
  41. Learning text editor semantics by analogy
  42. 10.1080/01449299108924268
  43. No easy answers: Investigating computer error messages
  44. 10.1163/9789004484511_004
  45. 10.1006/ceps.1993.1017