Does the manual help? An examination of the problem-solving support offered by manuals

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.

[1]  John T. Guthrie,et al.  Searching documents: Cognitive processes and deficits in understanding graphs, tables, and illustrations. , 1993 .

[2]  Michael Pressley,et al.  Prior Knowledge Affects Text Search Success and Extraction of Information. , 1993 .

[3]  Louis M. Gomez,et al.  Behavioral evaluation and analysis of a hypertext browser , 1989, CHI '89.

[4]  Susan T. Dumais,et al.  The vocabulary problem in human-system communication , 1987, CACM.

[5]  S. Yussen,et al.  Where Is It? Searching for Information in a College Textbook , 1993 .

[6]  Mariam Jean Dreher,et al.  Cognitive Processes in Textbook Chapter Search Tasks. , 1990 .

[7]  Ronald P. Carver,et al.  Reading Rate: Theory, Research, and Practical Implications. , 1992 .

[8]  M. Dreher.  Reading to locate information: societal and educational perspectives , 1993 .

[9]  Keith Oatley,et al.  Action Centred Manuals or Minimalist Instruction? Alternative Theories for Carroll’s Minimal Manuals , 1992 .

[10]  Robert E. Horn.  Structured writing at twenty‐five , 1993 .

[11]  Ard W. Lazonder,et al.  Error-information in tutorial documentation: Supporting users' errors to facilitate initial skill learning , 1995, Int. J. Hum. Comput. Stud..

[12]  Hans van der Meij.  Catching the user in the act , 1994 .

[13]  Jonathan Price,et al.  How to communicate technical information - a handbook of software and hardware documentation - How to write a computer manual , 1993 .

[14]  John M. Carroll,et al.  Ten misconceptions about minimalism , 1996 .

[15]  John M. Carroll,et al.  Toward minimalist training: Supporting the sense-making activities of computer users. , 1997 .

[16]  Adrianus W. Lazonder,et al.  Minimalist computer documentation : a study on constructive and corrective skills development , 1994 .

[17]  Richard P. Kern.  Modeling Users and Their Use of Technical Manuals , 1985 .

[18]  Bonnie B. Armbruster,et al.  Locating Information in Text: A Focus on Children in the Elementary Grades , 1993 .

[19]  John Millar Carroll.  The Nurnberg Funnel: Designing Minimalist Instruction for Practical Computer Skill , 1990 .

[20]  Arie Nadler,et al.  Help-seeking behavior: Psychological costs and instrumental benefits. , 1991 .

[21]  Hans van der Meij,et al.  Student questioning: A componential analysis , 1994 .

[22]  David K. Farkas.  Procedural and Declarative Information in Software Manuals: Effects of Information Use, Task Performance, and Knowledge. , 1997 .

[23]  S. Karabenick.  Relation of perceived teacher support of student questioning to students' beliefs about teacher attributions for questioning and perceived classroom learning environment , 1994 .

[24]  John T. Guthrie,et al.  Prior conceptual knowledge and textbook search , 1992 .

[25]  John M. Carroll,et al.  Blocking Learner Error States in a Training-Wheels System , 1984 .

[26]  Planning prompts and indexed terms in textbook search tasks , 1993 .

[27]  Michaël Steehouder.  Informatie zoeken in computerhandleidingen : Een verkenning van de problemen , 1993 .

[28]  J. T. Dillon.  Problem Finding and Solving , 1982 .

[29]  M. F. Steehouder,et al.  The quality of access: helping users find information in documentation , 1994, Quality of technical documentation.

[30]  Allen Newell,et al.  The psychology of human-computer interaction , 1983 .

[31]  Kristen R. Woolever,et al.  Writing for the Computer Industry , 1993 .

[32]  IEEE transactions on professional communication , 1986, IEEE Transactions on Professional Communication.

[33]  Patricia Wright.  Writing Technical Information , 1987 .

[34]  John M. Carroll,et al.  Principles and Heuristics for Designing Minimalist Instruction , 1998 .

[35]  Jochen Prümper,et al.  Some surprising differences between novice and expert errors in computerized office work , 1992 .

[36]  David K. Farkas,et al.  Minimalism reconsidered , 1992, ACM SIGCHI Bull..