Users: Programmers developing Smalltalk applications.
Problem: Frameworks are often difficult to use. The factoring of
complex Smalltalk programs leads to a hierarchy of classes that becomes a
framework for the creation of subclasses specialized to meet additional
requirements. Over time Smalltalk systems acquire a variety of frameworks that
are reusable if someone takes the trouble to identify and document them. This
is usually not the case. People who learn of them must study the entire class
hierarchy of the framework in order to create further specializations.
Solution: SmalltalkDoc supports the documentation of frameworks
through overview documents and through documents associated with bundles and
packages. Figures illustrating the conceptual structure of a framework can be
included, along with explanations. The overview documents can describe
structural relationships that span the packaging components.