A version-aware tool for design rationale

ABSTRACT

Software Concordance Design Rationale (SCDR) is a tool for recording design rationale, which describes the reasons that a system's design was chosen. Using the editing, linking, and versioning services of the Software Concordance system, SCDR allows developers to structure their design discussions and connect them to any of the other software documents used in the system. The versioning services, in particular, show developers the context of the design discussions, making those discussion comprehensible even in systems whose components have changed considerably over time.

REFERENCES

• 1: John Boyland, Aaron Greenhouse, and William L. Scherlis. Fluid IR: An internal representation for software engineering environment., 2005. Accessed at http://www.fluid.cs.cmu.edu:8080/Fluid.
• 2: Andrea Casotto , A. Richard Newton , Alberto Sangiovanni-Vincentelli, Design management based on design traces, Proceedings of the 27th ACM/IEEE conference on Design automation, p.136-141, June 24-27, 1990, Orlando, Florida, United States [doi>10.1145/123186.123241]
• 3: B. Chandrasekaran , Ashok K. Goel , Yumi Iwasaki, Functional Representation as Design Rationale, Computer, v.26 n.1, p.48-56, January 1993 [doi>10.1109/2.179157]
• 4: B. Childs and J Sametinger. Literate programming and documentation. In Software Reuse, 1996., Proceedings Fourth International Conference, pages 205--214, April 1996.
• 5: E. Jeffrey Conklin and K C Burgess Yakemovic. A process-oriented approach to design rationale. Human-Computer Interaction, 6(3-4):357--391, 1991.
• 6: Jeff Conklin , Michael L. Begeman, gIBIS: a hypertext tool for exploratory policy discussion, ACM Transactions on Information Systems (TOIS), v.6 n.4, p.303-331, Oct. 1988 [doi>10.1145/58566.59297]
• 7: Reidar Conradi , Bernhard Westfechtel, Version models for software configuration management, ACM Computing Surveys (CSUR), v.30 n.2, p.232-282, June 1998 [doi>10.1145/280277.280280]
• 8: Silvana Maria Affonso de Lara and Renata Pontin de Mattos Fortes. Um mecanismo de captura ubíquo para registro de design rationale de artefatos de software. In Anais de IV International Information and Telecommunication Technologies Symposium (I2TS 2005), v. 1, 2005.
• 9: G. Fischer, A. Lemke, R. McCall, and A. Morch. Making argumentation serve design. Human Computer Interaction, 6(3-4):393--419, 1991.
• 10: G. Fischer , R. McCall , A. Morch, Design environments for constructive and argumentative design, Proceedings of the SIGCHI conference on Human factors in computing systems: Wings for the mind, p.269-275, March 1989
• 11: A. Garcia, H. Howard, and M. Stefik. Active design documents: A new approach for supporting documentation in preliminary routine design. Tech. Report, 82, 1993. Stanford Univ. Center for Integrated Facility Engineering, Stanford, CA.
• 12: Xiaochun Hu, Jun Pang, Yan Pang, Michael Atwood, and Wei Sunand William C. Regli. Survey on design rationale: capture, representation and retrieval. In 2000 ASME Design Engineering Technical Conferences and the Computers and Information in Engineering Conference, September 2000.
• 13: W. Kunz and W. Rittel. Issues as elements of information systems. Working paper 131, Center for Planning and Development Research, University of California, Berkeley, August 1970.
• 14: Jintae Lee, SIBYL: A qualitative decision management system, Artificial intelligence at MIT expanding frontiers, MIT Press, Cambridge, MA, 1991
• 15: Jintae Lee, Design Rationale Systems: Understanding the Issues, IEEE Expert: Intelligent Systems and Their Applications, v.12 n.3, p.78-85, May 1997 [doi>10.1109/64.592267]
• 16: Allan MacLean , Richard M. Young , Victoria M. E. Bellotti , Thomas P. Moran, Questions, options, and criteria: elements of design space analysis, Design rationale: concepts, techniques, and use, Lawrence Erlbaum Associates, Inc., Mahwah, NJ, 1996
• 17: R. McCall. Phi: A conceptual foundation for design hypermedia. Design Studies, 12(1):30--41, January 1991.
• 18: Ethan V. Munson. The Software Concordance: Bringing hypermedia to the software development process. In SBMIDIA '99 Anais, V Simpósio Brasileiro de Sistemas Multimídia e Hipermídia, Goiânia, Brazil, June 1999.
• 19: Karen L. Myers , Nina B. Zumel , Pablo Garcia, Automated capture of rationale for the detailed design process, Proceedings of the sixteenth national conference on Artificial intelligence and the eleventh Innovative applications of artificial intelligence conference innovative applications of artificial intelligence, p.876-883, July 18-22, 1999, Orlando, Florida, United States
• 20: Tien Nguyen , Satish Chandra Gupta , Ethan V. Munson, Versioned Hypermedia can improve software document management, Proceedings of the thirteenth ACM conference on Hypertext and hypermedia, June 11-15, 2002, College Park, Maryland, USA [doi>10.1145/513338.513385]
• 21: Tien N. Nguyen , Ethan V. Munson, The software concordance: a new software document management environment, Proceedings of the 21st annual international conference on Documentation, October 12-15, 2003, San Francisco, CA, USA [doi>10.1145/944868.944911]
• 22: Tien N. Nguyen , Ethan V. Munson , John T. Boyland , Cheng Thao, An infrastructure for development of object-oriented, multi-level configuration management services, Proceedings of the 27th international conference on Software engineering, p.215-224, May 15-21, 2005, St. Louis, MO, USA [doi>10.1145/1062455.1062504]
• 23: F. Pena-Mora and S. Vadhavkar. Design rationale and design patterns in reusable software design. In J. Gero and F. Sudweeks, editors, Artificial Intelligence in Design 96, Kluwer Academic Press, 1996.
• 24: H. Rittel. Second generation design methods, 1984. In Developments in Design Methodology, N. Cross, Ed., John Wiley & Sons, New York.
• 25: J. R. Rossignac, P. Borrel, and L. R. Nackman. Intelligent CAD systems II: implementational issues, pages 93--125. Springer-Verlag New York, Inc., 1989.
• 26: Johannes Sametinger , Matthias Riebisch, Evolution Support by Homogeneously Documenting Patterns, Aspects and Traces, Proceedings of the 6th European Conference on Software Maintenance and Reengineering, p.134, March 11-13, 2002
• 27: F. M. Shipman III and R. J. McCall. Integrating different perspectives on design rationale: Supporting the emergence of design rationale from design communication. Artificial Intelligence for Engineering Design, Analysis and Manufacturing, 11(2):141--154, April 1997.
• 28: Wang Xin and Xiong Guangleng. Design rationale as part of corporate technical memory. In Systems, Man, and Cybernetics, 2001 IEEE International Conference, volume 3, pages 1904--1908, October 2001.

INDEX TERMS

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

Additional Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.7 Distribution, Maintenance, and Enhancement
          Subjects: Documentation; Restructuring, reverse engineering, and reengineering
      D.2.9 Management
          Subjects: Software configuration management

  K. Computing Milieux
  K.6 MANAGEMENT OF COMPUTING AND INFORMATION SYSTEMS
      K.6.3 Software Management
          Subjects: Software maintenance

General Terms:
Design, Documentation, Management