
However, since the browser deals almost exclusively with method and class definitions, it is difficult to use it for maintaining documentation of concepts and relationships between classes and class hierarchies.
ParcPlace has used ordinary methods with just comment in them for this purpose in some cases (for example, the various ObjectMemory spaces are described in such methods). This approach works but does not help the user in finding the information he's looking for, because it is still not presented in a structured way.
Therefore, I propose that hypertext concepts such as the WWW approach be used to create a kind of "hyper-literate programming" style for Smalltalk. A hyper-literate Smalltalk program would be a hypertext document that includes not only the source code (with class and method comments) but also an orderly presentation of the classes and their relations, example code to be executed, references to external documents etc.
The environment should support at least the dynamic cross-referencing that is currently implemented in browsers, plus static links and comfortable text formatting.