DejaVU Online - The hush Documents
For a number of years, we have used hush
in our Software Engineering course and
we were confronted with the need
to keep our documentation up to date.
Naturally, we provided online help including references to external
sources of information.
But often students also wanted to be able
to look at the sources,
and not only include files, as well.
It is interesting to note here that most vendors of
C++ class libraries we one day or another forced
to give their source code away,
simply because it appeared to be too difficult to understand the nature
of their frameworks in any other way.
slide: DejaVU Online - The hush Documents
Our inability to document software in an adequate way is
an amusing problem in itself.
It's solution may lie in the adoption of
proper development methods
and possibly in finding more intuitive means
of clarifying the (conceptual) relations
between the components of the system.
An unsolved problem, in this stage, let me haste to add!