A cookbook for using the model-view controller user interface paradigm in Smalltalk-80
Journal of Object-Oriented Programming
The Nurnberg funnel: designing minimalist instruction for practical computer skill
The Nurnberg funnel: designing minimalist instruction for practical computer skill
Documenting frameworks using patterns
OOPSLA '92 conference proceedings on Object-oriented programming systems, languages, and applications
Design patterns: elements of reusable object-oriented software
Design patterns: elements of reusable object-oriented software
Design patterns for object-oriented software development
Design patterns for object-oriented software development
Automated support for software development with frameworks
SSR '95 Proceedings of the 1995 Symposium on Software reusability
Pattern-oriented software architecture: a system of patterns
Pattern-oriented software architecture: a system of patterns
Hooking into object-oriented application frameworks
ICSE '97 Proceedings of the 19th international conference on Software engineering
A pattern language for pattern writing
Pattern languages of program design 3
Development of successful object-oriented frameworks
Addendum to the 1997 ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (Addendum)
Java Swing
Building application frameworks: object-oriented foundations of framework design
Building application frameworks: object-oriented foundations of framework design
Implementing application frameworks: object-oriented frameworks at work
Implementing application frameworks: object-oriented frameworks at work
A framework for framework documentation
ACM Computing Surveys (CSUR)
Consistent framework documentation with computed links and framework contracts
ACM Computing Surveys (CSUR)
The Power of Frameworks: For Windows and OS/2 Developers
The Power of Frameworks: For Windows and OS/2 Developers
Core J2EE Patterns: Best Practices and Design Strategies
Core J2EE Patterns: Best Practices and Design Strategies
Inside Taligent Technology
The Java Language Specification
The Java Language Specification
Patterns Generate Architectures
ECOOP '94 Proceedings of the 8th European Conference on Object-Oriented Programming
Developing Quality Technical Information: A Handbook for Writers and Editors (2nd Edition)
Developing Quality Technical Information: A Handbook for Writers and Editors (2nd Edition)
Patterns for documenting frameworks: customization
Proceedings of the 2006 conference on Pattern languages of programs
Hi-index | 0.00 |
Good design and implementation are necessary but not sufficient prerequisites for successfully reusing object-oriented frameworks. Although not always recognized, good documentation is crucial for effective framework reuse, and often hard, costly, and tiresome, coming with many issues, especially when we are not aware of the key problems and respective ways of addressing them. Based on existing literature, case studies and lessons learned, the authors have been mining proven solutions to recurrent problems of documenting object-oriented frameworks, and writing them in pattern form, as patterns are a very effective way of communicating expertise and best practices. This paper presents a small set of patterns addressing problems related to the framework documentation itself, here seen as an autonomous and tangible product independent of the process used to create it. The patterns aim at helping nonexperts on cost-effectively documenting object-oriented frameworks. In concrete, these patterns provide guidance on choosing the kinds of documents to produce, how to relate them, and which contents to include. Although the focus is more on the documents themselves, rather than on the process and tools to produce them, some guidelines are also presented in the paper to help on applying the patterns to a specific framework.