Comparison of different documentation styles for frameworks of object-oriented code

Frameworks are increasingly employed as a useful way to enable object-oriented reuse. However, understanding frameworks is not easy due to their size and complexity. Previous work concentrated on different ways to document frameworks, but it was unclear which ones were actually better. This paper presents a novel way of investigating the different philosophies for framework documentation. The philosophies include minimalist, patterns-style and extended javadoc (Jdoc) documentation. Using a survey of 140 novices engaged in Swing intensive coding work, this empirical study discovered some guidelines for effective framework documentation for the Swing framework. The results suggest that different documentation is better for different goals.