Eric Faurot wrote:
>I agree. I suggest that we create yet another module for the
>documentation. Anyway, if we want to add the docs for extensions,
>it should not be kept only in the libggi tree. The other solution
>is to split the documentation across all modules.
>
yeah, I think I prefer the latter. The docs should be as closely tied to
the sources they are supposed
to document, to make it easier and convenient for the developers to keep
them in sync.
The home page then should have a 'root document' that references all the
docs within the individual
projects.
Also, there exist a number of tools for online browsing of source code,
such as used by mozilla,
GNOME, the linux kernel, or berlin. It would be a really nice-to-have
feature to provide such a tool
as well. With this, the documentation page could contain two sets of
documents, a set of tutorials,
HOWTOs, FAQs, etc., as well as a set of reference manuals and cross
referenced and annotated
sources (part of which would be the cvsview tool at sourceforge).
Regards, Stefan
