Implementing Case-Based Reasoning Approach to Framework Documentation

Several approaches are currently used in documenting object-oriented application frameworks.  Traditional documentation approaches include tutorials, reference manuals, design patterns, cookbooks, and minimalist.  The main objective of a framework is to dramatically reduce the time and effort needed in developing complete applications within a family of applications domain.  Proper documentation is required in order for a framework to be usable to users, especially to the new users of the framework.  This paper discusses and implements the case-based reasoning (CBR) approach to documenting a framework.  It is believed that the fastest way to learn is by retrieving previously recorded framework usage experiences or cases.  Here, a case is a complete example of how to use a particular component or a set of components within a framework.  In CBR, reasoning is based on remembering past cases.  Genetic algorithm (GA) is used in implementing the CBR's "retrieve", "reuse", and "revise" steps.  During the "revise" and "retain" steps of the CBR, Knuth-Morris-Pratt (KMP) pattern matching algorithm is applied.

[1]  A. Wojciechowski,et al.  Identifying students usability needs in collaborative learning environments , 2008, 2008 Conference on Human System Interactions.

[2]  Pedro A. González-Calero,et al.  Profiting from case-based reasoning in framework documentation , 2001, Proceedings Technology of Object-Oriented Languages and Systems. TOOLS 38.

[3]  Ralph E. Johnson,et al.  Documenting frameworks using patterns , 1992, OOPSLA '92.

[4]  Marcelo R. Campo,et al.  Accomplishing adaptability in simulation frameworks: the Bubble approach , 2000, 25th Annual International Computer Software and Applications Conference. COMPSAC 2001.

[5]  Kasper Østerbye Minimalist Documentation of Frameworks , 1999, ECOOP Workshops.

[6]  S.P. Lee,et al.  Applying case reuse and rule-based reasoning (RBR) in object-oriented application framework documentation: Analysis and design , 2008, 2008 Conference on Human System Interactions.

[7]  Paul G. Sorenson,et al.  Hooking into Object-Oriented Application Frameworks , 1997, Proceedings of the (19th) International Conference on Software Engineering.

[8]  Ian Chai,et al.  Pedagogical framework documentation: how to document object-oriented frameworks. an empirical study , 1999 .

[9]  Marcus E. Markiewicz,et al.  Object oriented framework development , 2001, CROS.

[10]  Hajar Mat Jani Lee Sai Peck A Study on Object-Oriented Application Frameworks Documentation: Documenting Approaches , 2004 .

[11]  Agnar Aamodt,et al.  Case-Based Reasoning: Foundational Issues, Methodological Variations, and System Approaches , 1994, AI Commun..