Abstract

The paper examines whether manuals provide adequate help for users who are experiencing a problem. First, an outline is given of the main stages in problem solving. This outline offers a broad framework for the two studies of current practice that follow. The first study focuses on the accessibility of help. It examines how often manuals fail to offer the right keywords, and how often they have not marked or have misplaced problem solving information. The main conclusion is that most manuals pose formidable obstacles to accessing help. The second study investigates the main reasons for presenting problem solving information as a regular step, as a skipable action, or as an afterthought. The main finding is that writers or typographers tend to opt for a different design than what is theoretically best.

Journal
IEEE Transactions on Professional Communication
Published
1996-01-01
DOI
10.1109/47.536263
CompPile
Open Access
OA PDF Green
Export

Citation Context

Cited by in this index (4)

  1. IEEE Transactions on Professional Communication
  2. IEEE Transactions on Professional Communication
  3. IEEE Transactions on Professional Communication
  4. Journal of Technical Writing and Communication

References (48) · 2 in this index

  1. 10.1002/pfi.4170320206
  2. Does the manual help? An examination of the problem-solving behavior of users and the support manuals offer
  3. principles and heuristics for designing minimalist instruction
    Tech Commun
  4. 10.2307/747997
  5. quality or usability? quality writing provokes quality reading
    Quality of Technical Documentation  
Show all 48 →
  1. 10.1006/ceps.1993.1017
  2. Procedural and declarative information in software manuals What do users actually use?
  3. how do users read computer manuals? some protocol contributions to writers' knowledge
    Convergences Transactions in Reading and Writing
  4. reading rate: theory, research and practical implications
    J Reading
  5. collecting descriptions of text-processing problems for a user-friendly manual
    Quality of Technical Documentation  
  6. literacy as search: explorations via computer
    Cognition Education and Multimedia Exploring Ideas in High Technology
  7. 10.1016/B978-0-12-223260-2.50018-9
  8. IEEE Transactions on Professional Communication
  9. The Psychology of Everyday Things
  10. 10.1016/1041-6080(94)90007-8
  11. 10.2307/1167315
  12. 10.1049/sqj.1958.0009
  13. problem finding and creative thought
    Questioning Exchange
  14. a question theoretic analysis of problem formulation: implications for computer-based support
    Questions and Information Systems
  15. Online Help Design and Evaluation
  16. 10.2307/747694
  17. The Psychology of Human-Computer Interaction
  18. 10.1006/ceps.1993.1015
  19. the quality of access: helping users find information in documentation
    Quality of Technical Documentation  
  20. Writing for the Computer Industry
  21. Minimalist computer documentation A study on constructive and corrective skills development
  22. blocking learner error states in a training-wheels system
    Human Factors  
  23. 10.1016/0361-476X(92)90042-W
  24. 10.1002/j.2162-6057.1982.tb00326.x
  25. 10.1006/ijhc.1995.1009
  26. How to Communicate Technical Information
  27. 10.1006/ceps.1993.1014
  28. Writing Better User Documentation From Paper to Hypertext (Version 2)
  29. 10.1145/142386.142393
  30. informatie zoeken in computerhandleidingen: een verkenning van problemen
    Tijdschrift voor Taalbeheersing
  31. techniques for minimalist documentation and user interface design
    Quality of Technical Documentation  
  32. help-seeking behavior: psychological costs and instrumental benefits
    Prosocial Behavior
  33. 10.1080/01449299208924353
  34. action centered manuals or minimalist instruction? alternative theories for carroll's min…
    Computers and Writing State of the Art
  35. 10.1016/1041-6080(94)90009-4
  36. IEEE Transactions on Professional Communication
  37. 10.1037/0022-0663.85.4.662
  38. The Chicago Manual of Style
  39. 10.1006/ceps.1993.1019
  40. The Nurnberg Funnel Designing Minimalist Instruction for Practical Computer Skill
  41. 10.1145/32206.32212
  42. Indexing and Abstracting in Theory and Practice
  43. 10.1037/10260-012