Please use this identifier to cite or link to this item: http://repositorio.inesctec.pt/handle/123456789/2995
Title: Patterns for Effectively Documenting Frameworks in "Transactions on Pattern Languages of Programming II"
Authors: Ademar Aguiar
Gabriel David
Keywords: Patterns;object-oriented frameworks;documentation
Issue Date: 2011
Abstract: Good design and implementation are necessary but not sufficient pre- requisites for successfully reusing object-oriented frameworks. Although not always recognized, good documentation is crucial for effective framework re- use, 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 ob- ject-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 inde- pendent of the process used to create it. The patterns aim at helping non-experts 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.
URI: http://repositorio.inesctec.pt/handle/123456789/2995
metadata.dc.type: bookPart
Publication
Appears in Collections:CSIG - Book Chapters

Files in This Item:
File Description SizeFormat 
PS-07461.pdf1.64 MBAdobe PDFView/Open


Items in DSpace are protected by copyright, with all rights reserved, unless otherwise indicated.