ABSTRACT
The effects of general global documentation, detailed step-by-step documentation, and combined global and detailed documentation were examined for high, medium, and low experienced students. The 198 students in this study used a word-processing program to complete two problems during a two-hour session. Results from univariate and multivariate analyses indicated that both general time measures for reading documentation and completing problems as well as the student users' reactions to the documentation, the program, and the computer system were affected by either the type of documentation, the level of experience, or both of these factors.
- Boehm-Davis, D.A. ana Fregly, A. M. (1985) Documentation of Concurrent Programs, Human Factors, 27, 423-432Google ScholarCross Ref
- Brooks, R. (1982) A theoretical analysis of the role of documentation in the compehension of computer programs. In Proceedings of the Human Factors in Computer Systems Conference. Gaithersburg, MA: Institute for Computer Sciences & Technology. Google ScholarDigital Library
- Isa, B. S., Neal, A. A., Evey, R. J., and McVey, B.W. (1982) Roadmaps versus roadsigns: Which is the better metalanguage? In Proceedings of the 26th Annual Meeting of the Human Factors Society. SantaMonica, CA: The Human Factors Society, Inc.Google ScholarCross Ref
- Norcio, A. F. (1982) Indentation, documentation and programmer comprehension. In Proceedings of the Human Factors in Computer Systems Conference. Gaithersburg, MA: Institute for Computer Sciences & Technology. Google ScholarDigital Library
- Norman, D. A. (1982) Steps toward a cognitive engineering: Design rules based on analysis of human error.In Proceedings of the Human Factors in Computer Systems Conference. Gaithersburg, MA: Institute for Computer Sciences & Technology. Google ScholarDigital Library
- Sheppard, S. B., Curtis, B., Milliman, P., and Love, T. (1979) Modern coding practices and programmer performance. Computer, 12 (12), pp 41-49.Google ScholarDigital Library
- Sheppard, S. B., Kruesi, E., and Curtis, B. (1981) The effects of symbology and spatial arrangement on the comprehension of software specification." In Proceedings of the Fifth International Conference on Software Enginneerinq. Copyright, the Institute of Electrical and Electronics Engineers, Inc. Google ScholarDigital Library
Index Terms
- The effects of structured, multi-level documentation
Recommendations
The effects of structured, multi-level documentation
Special issue: CHI '86 Conference ProceedingsThe effects of general global documentation, detailed step-by-step documentation, and combined global and detailed documentation were examined for high, medium, and low experienced students. The 198 students in this study used a word-processing program ...
Documentation threads - presentation of fragmented documentation
In this paper, we introduce a means for presenting fragmented documentation through a concept called documentation threads. A documentation thread presents a number of documentation fragments specified by the programmer and can guide a documentation ...
Modeling, encoding and querying multi-structured documents
The issue of multi-structured documents became prominent with the emergence of the digital Humanities field of practices. Many distinct structures may be defined simultaneously on the same original content for matching different documentary tasks. For ...
Comments