Designing documentation to compensate for delocalized plans

Communications of the ACM

Volumn 31, Issue 11, 1988, Pages 1259-1267

  Soloway, Elliot ^a   Lampert, Robin ^a   Letovsky, Stan ^b   Littman, David ^b   Pinto, Jeannine ^c  

^a UNIVERSITY OF MICHIGAN   (United States)

^b YALE UNIVERSITY   (United States)

^c UNIVERSITY OF VIRGINIA   (United States)

Author keywords

Empirical studies of programmers; representations of software

Indexed keywords

COMPUTER PROGRAMMING--HUMAN FACTORS; PERSONNEL--PRODUCTIVITY;

PROGRAMMER PRODUCTIVITY; SOFTWARE DOCUMENTATION; SOFTWARE QUALITY;

COMPUTER SOFTWARE;

EID: 0024108251     PISSN: 00010782     EISSN: 15577317     Source Type: Journal    
DOI: 10.1145/50087.50088     Document Type: Article

References (20)

1. Adelson, B., and Soloway, E. The role of domain experience in software design. IEEE Trans. Softw. Eng. (Nov. 1985)
2. Brooks, F.B. No silver bullet: essence and accidents in software engineering. IEEE Comput., (Apr. 1987), 10–19.
3. Carroll,J., and Campbell, R. Artifacts as psychological theories: the case of human-computer interaction. Res. Rep. RC 13454. IBM Watson Research Center, Yorktown Heights, N.Y., 1988.
4. Curtis, B., Sheppard, S.B., Kruesi-Bailey, E., Bailey, J., and Boehm-Davis, D. Experimental evaluation of software documentation formats. J. Syst. Softw. In press.
5. Fagan, M.E. Design and code inspections reduce errors in program development. IBM Syst. J. 25, 3 (Mar. 1976), 219–248.
6. Gould, J. Some psychological evidence on how people debug computer programs. Int. J. Man-Machine Stud. 7, 1 (Jan. 1975), 151–182.
7. Kolkhorst, B.G. Space shuttle primary onboard software development: process control and defect cause analysis. Unpublished, IBM report. Houston, TX.
8. Lampert, R., Hamilton, D., and Soloway, E. A study of the knowledge needed to test complex software systems. In Proceedings of the 12th NASA/Goddard Software Engineering Workshop (Greenbelt, Md.), 1987
9. Letovsky, S., and Soloway, E. Delocalized plans and program comprehension. IEEE Softw. (May 1986)
10. Littman, D., Pinto, J., Letovsky, S., and Soloway, E. Mental models and software maintenance. In Empirical Studies of Programmers, Soloway and Iyengar, Eds. Ablex, N.J., 1986
11. Reiss, S. PECAN: Program development systems that support multiple views. In Proceedings of the Seventh International Conference on Software Engineering, (Pittsburgh, Pa., 1984).
12. Rich, C. Inspection methods in programming. Tech. Rep. AI-TR-604, MIT Al Lab, Cambridge, Mass., 1981.
13. Sheppard, S., Curtis, B., Milliman, P., and Love, T. Modern coding practices and programmer performance. IEEE Comput. (Dec. 1979), 41–49.
14. Shneiderman, B. Control flow and data structure documentation: Two experiments. Commun. ACM 25, 1 (Jan. 1982), 55–63.
15. Shneiderman, B., Shafer, P., Simon, R., and Weldon, L. Display strategies for program browsing: concepts and experiment. IEEE Softw. (May 1986).
16. Soloway, E., and Ehrlich, K. Empirical studies of programming knowledge. IEEE Trans. Softw. Eng. (Sept. 1984)
17. Soloway, E., Pinto, J., Fertig, S., Letovsky, S., Lampert, R., Littman, D., and Ewing, K. Studying software documentation from a cognitive perspective: a status report. In Proceedings of the 10th Annual NASA/ Goddard Software Engineering Workshop (Greenbelt, Md.), 1986.
18. Weiser, M. Programmers use slices when debugging. Commun. ACM 25, 7 (July 1982), 446–452.
19. Weiser, M., and Lyle,J. Experiments on slicing-based debugging aids. In Empirical Studies of Programmers, E. Soloway and S. Iyengar, Eds. Ablex, N.J., 1986
20. Yourdon, E., and Constantine, L. Structured Design: Fundamentals of a Discipline of Computer Program and Systems Design. Prentice Hall, Englewood Cliffs, N.J., 1979.