Patterns for documenting frameworks

Ademar Aguiar, Gabriel David
2006 Proceedings of the 2006 conference on Pattern languages of programs - PLoP '06  
Good design and implementation are necessary but not sufficient pre-requisites for the successful reuse of object-oriented frameworks. Although not always recognized, good documentation is crucial for effective framework reuse but comes with many issues. Writing good quality documentation for a framework is often hard, costly, and tiresome, especially when not aware of its key problems and the best ways to address them. This document presents two of a set of related patterns that describe
more » ... solutions to help non-experts on solving recurrent problems of documenting object-oriented frameworks. The patterns here presented address the problems of describing the customization points of the framework and how such customization is supported, respectively the patterns "CUSTOMIZATION POINTS" and "DESIGN INTERNALS".
doi:10.1145/1415472.1415491 fatcat:xlks47ybtnd3jmxoy35vvxjf74