article

Free access

Designing documentation to compensate for delocalized plans

Authors:

Jeannine PintoAuthors Info & Claims

Communications of the ACM, Volume 31, Issue 11

Pages 1259 - 1267

https://doi.org/10.1145/50087.50088

Published: 01 November 1988 Publication History

PDF eReader

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]

Adelson, B., and Soloway, E. The role of domain experience in software design. IEEE Trans. Sofiw. Eng. (Nov. 1985),

Digital Library

Google Scholar

[2]

Brooks, F.B. No silver bullet: essence and accidents in software engineering. IEEE Comput., (Apr. 1987), 10-19.

Digital Library

Google Scholar

[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.

Google Scholar

[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.

Digital Library

Google Scholar

[5]

Fagan, M.E. Design and code inspections reduce errors in program development. IBM Syst. J. 15, 3 (Mar. 1976), 219-248.

Digital Library

Google Scholar

[6]

Gould, J. Some psychological evidence on how people debug computer programs. Int. J. Man-Machine Stud. 7, 1 (Jan. 1975), 151-182.

Crossref

Google Scholar

[7]

Kolkhorst, B.G. Space shuttle primary onboard software development: process control and defect cause analysis. Unpublished, IBM report. Houston, TX.

Google Scholar

[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,

Google Scholar

[9]

Letovsky, S., and Soloway, E. Delocalized plans and program comprehension. IEEE Softw. (May 1986),

Google Scholar

[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,

Digital Library

Google Scholar

[11]

Reiss, S. PECAN: Program development systems that support multiple views. In Proceedings of the Seventh International Conference on Software Engineering, (Pittsburgh, Pa., 1984).

Digital Library

Google Scholar

[12]

Rich, C. Inspection methods in programming. Tech. Rep. AI-TR-604, MIT AI Lab, Cambridge, Mass., 1981.

Digital Library

Google Scholar

[13]

Sheppard, S., Curtis, B., Milliman, P., and Love, T. Modern coding practices and programmer performance. IEEE Comput. (Dec. 1979), 41-49.

Digital Library

Google Scholar

[14]

Shneiderman, B. Control flow and data structure documentation: Two experiments. Commun. ACM 25, 1 (Jan. 1982), 55-63.

Digital Library

Google Scholar

[15]

Shneiderman, B., Shafer, P., Simon, R., and Weldon, L. Display strategies for program browsing: concepts and experiment. IEEE Softw. (May 1986}.

Google Scholar

[16]

Soloway, E., and Ehrlich, K. Empirical studies of programming knowledge. IEEE Trans. Softw. Eng. (Sept. 1984},

Google Scholar

[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.

Google Scholar

[18]

Weiser, M. Programmers use slices when debugging. Commun. ACM 25, 7 (July 1982), 446-452.

Digital Library

Google Scholar

[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,

Digital Library

Google Scholar

[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,

Digital Library

Google Scholar

Cited By

View all

Mehrpour SLatoza T(2023)A Survey of Tool Support for Working with Design Decisions in CodeACM Computing Surveys10.1145/360786856:2(1-37)Online publication date: 10-Jul-2023
https://dl.acm.org/doi/10.1145/3607868
Khomokhoana PNel L(2023)A Framework to Assist Instructors Help Novice Programmers to Better Comprehend Source Code ─ A Decoding PerspectiveComputational Science and Its Applications – ICCSA 202310.1007/978-3-031-36805-9_44(677-693)Online publication date: 3-Jul-2023
https://dl.acm.org/doi/10.1007/978-3-031-36805-9_44
Busjahn TBednarik RBegel ACrosby MPaterson JSchulte CSharif BTamm SDe Lucia ABird COliveto R(2015)Eye movements in code readingProceedings of the 2015 IEEE 23rd International Conference on Program Comprehension10.5555/2820282.2820320(255-265)Online publication date: 16-May-2015
https://dl.acm.org/doi/10.5555/2820282.2820320
Show More Cited By

Index Terms

Designing documentation to compensate for delocalized plans
1. Software and its engineering
  1. Software creation and management
    1. Software development techniques
      1. Reusability

Recommendations

Automaton plans

Macros have long been used in planning to represent subsequences of operators. Macros can be used in place of individual operators during search, sometimes reducing the effort required to find a plan to the goal. Another use of macros is to compactly ...
Macros, reactive plans and compact representations
ECAI'12: Proceedings of the 20th European Conference on Artificial Intelligence

The use and study of compact representations of objects is widespread in computer science. AI planning can be viewed as the problem of finding a path in a graph that is implicitly described by a compact representation in a planning language. However, ...
Explaining design plans

The paper describes a methodology for generating quality explanations from design plans. In selecting items of information for inclusion in an explanation, the methodology considers the rationales behind the strategic knowledge and object-level ...

Comments

Information & Contributors

Information

Published In

Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 01 November 1988

Published in CACM Volume 31, Issue 11

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Qualifiers

Article

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

133
Total Citations
View Citations
892
Total Downloads

Downloads (Last 12 months)71
Downloads (Last 6 weeks)7

Reflects downloads up to 15 Oct 2024

Other Metrics

View Author Metrics

Citations

Cited By

View all

Mehrpour SLatoza T(2023)A Survey of Tool Support for Working with Design Decisions in CodeACM Computing Surveys10.1145/360786856:2(1-37)Online publication date: 10-Jul-2023
https://dl.acm.org/doi/10.1145/3607868
Khomokhoana PNel L(2023)A Framework to Assist Instructors Help Novice Programmers to Better Comprehend Source Code ─ A Decoding PerspectiveComputational Science and Its Applications – ICCSA 202310.1007/978-3-031-36805-9_44(677-693)Online publication date: 3-Jul-2023
https://dl.acm.org/doi/10.1007/978-3-031-36805-9_44
Busjahn TBednarik RBegel ACrosby MPaterson JSchulte CSharif BTamm SDe Lucia ABird COliveto R(2015)Eye movements in code readingProceedings of the 2015 IEEE 23rd International Conference on Program Comprehension10.5555/2820282.2820320(255-265)Online publication date: 16-May-2015
https://dl.acm.org/doi/10.5555/2820282.2820320
Szabo CBertolino ACanfora GElbaum S(2015)Novice code understanding strategies during a software maintenance assignmentProceedings of the 37th International Conference on Software Engineering - Volume 210.5555/2819009.2819052(276-284)Online publication date: 16-May-2015
https://dl.acm.org/doi/10.5555/2819009.2819052
Gao YHou D(2015)ArchFLocProceedings of the 2015 IEEE International Conference on Software Maintenance and Evolution (ICSME)10.1109/ICSM.2015.7332482(333-335)Online publication date: 29-Sep-2015
https://dl.acm.org/doi/10.1109/ICSM.2015.7332482
Szabo C(2015)Novice Code Understanding Strategies during a Software Maintenance Assignment2015 IEEE/ACM 37th IEEE International Conference on Software Engineering10.1109/ICSE.2015.341(276-284)Online publication date: May-2015
https://doi.org/10.1109/ICSE.2015.341
Busjahn TBednarik RBegel ACrosby MPaterson JSchulte CSharif BTamm S(2015)Eye Movements in Code ReadingProceedings of the 2015 IEEE 23rd International Conference on Program Comprehension10.1109/ICPC.2015.36(255-265)Online publication date: 18-May-2015
https://dl.acm.org/doi/10.1109/ICPC.2015.36
Zhi JGarousi-Yusifoğlu VSun BGarousi GShahnewaz SRuhe G(2015)Cost, benefits and quality of software development documentationJournal of Systems and Software10.1016/j.jss.2014.09.04299:C(175-198)Online publication date: 1-Jan-2015
https://dl.acm.org/doi/10.1016/j.jss.2014.09.042
Sajaniemi JIkonen K(2014)VinEd — Asystem for programmanipulation through user-definable simultaneous viewsSoftware - Concepts & Tools10.1007/s00378005001619:3(130-140)Online publication date: 25-Apr-2014
https://doi.org/10.1007/s003780050016
Garousi VShahnewaz SKrishnamurthy D(2013)UML-Driven Software Performance EngineeringProgressions and Innovations in Model-Driven Software Engineering10.4018/978-1-4666-4217-1.ch002(18-64)Online publication date: 2013
https://doi.org/10.4018/978-1-4666-4217-1.ch002
Show More Cited By

View Options

View options

PDF

View or Download as a PDF file.

PDF

eReader

View online with eReader.

eReader

Get Access

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Abstract

References

Cited By

Index Terms

Recommendations

Automaton plans

Macros, reactive plans and compact representations

Explaining design plans

Comments

Information

Published In

Publisher

Publication History

Permissions

Check for updates

Qualifiers

Contributors

Other Metrics

Bibliometrics

Article Metrics

Other Metrics

Citations

Cited By

View options

PDF

eReader

Get Access

Login options

Full Access

Figures

Other

Share

Share this Publication link

Share on social media

Affiliations