Designing documentation to compensate for delocalized plans

ABSTRACT

Conceptual representation methods play a significant role in facilitating the software process. Recent studies explore and clarify the use of these representations and their impact on progress.

REFERENCES

• 1: Beth Adelson , Elliot Soloway, The role of domain experience in software design, IEEE Transactions on Software Engineering, v.11 n.11, p.1351-1360, Nov. 1985 [doi>10.1109/TSE.1985.231883]
• 2: Frederick P. Brooks, Jr., No silver bullet: essence and accidents of software engineering, Computer, v.20 n.4, p.10-19, April 1987 [doi>10.1109/MC.1987.1663532]
• 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: B. Curtis , S. B. Sheppard , E. Kruesi-Bailey , J. Bailey , D. A. Boehm-Davis, Experimental evaluation of software documentation formats, Journal of Systems and Software, v.9 n.2, p.167-207, February 1, 1989 [doi>10.1016/0164-1212(89)90019-8]
• 5: Fagan, M.E. Design and code inspections reduce errors in program development. IBM Syst. J. 15, 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: David C. Littman , Jeannine Pinto , Stanley Letovsky , Elliot Soloway, Mental models and software maintenance, Papers presented at the first workshop on empirical studies of programmers on Empirical studies of programmers, p.80-98, June 1986, Washington, D.C., United States
• 11: Steven P. Reiss, Pecan: Program development systems that support multiple views, Proceedings of the 7th international conference on Software engineering, p.324-333, March 26-29, 1984, Orlando, Florida, United States
• 12: Charles Rich, Inspection Methods in Programming: Cliches and Plans, Massachusetts Institute of Technology, Cambridge, MA, 1987
• 13: Sheppard, S., Curtis, B., Milliman, P., and Love, T. Modern coding practices and programmer performance. IEEE Comput. (Dec. 1979), 41-49.
• 14: Ben Shneiderman, Control flow and data structure documentation: two experiments, Communications of the ACM, v.25 n.1, p.55-63, Jan. 1982 [doi>10.1145/358315.358391]
• 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 lOth Annual NASA/ Goddard Software Engineering Workshop (Greenbelt, Md.), 1986.
• 18: Mark Weiser, Programmers use slices when debugging, Communications of the ACM, v.25 n.7, p.446-452, July 1982 [doi>10.1145/358557.358577]
• 19: Mark Weiser , Jim Lyle, Experiments on slicing-based debugging aids, Papers presented at the first workshop on empirical studies of programmers on Empirical studies of programmers, p.187-197, June 1986, Washington, D.C., United States
• 20: Edward Yourdon , Larry L. Constantine, Structured Design: Fundamentals of a Discipline of Computer Program and Systems Design, Prentice-Hall, Inc., Upper Saddle River, NJ, 1979

INDEX TERMS

Primary Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.7 Distribution, Maintenance, and Enhancement
          Subjects: Extensibility**

Additional Classification:
  D. Software
  D.m MISCELLANEOUS
      Subjects: Software psychology**

General Terms:
Documentation, Experimentation, Human Factors