Position of existing documentation in new scheme


Kim Lester (kim@dfusion.com.au)
Tue, 11 Jan 2000 01:53:48 +0000


Following on from Martin's comments about editing
of existing comments:

As der.hans said we should try and put the effort
back on the authors (instant volunteer generally
with a vested interest) Although this many
not be practical in every case.

In the mean time how about the following:

Define format.
Convert some key docs to this "core" format.
Such docs would have full categorisation/indexing
features.
All other docs would be palced in an outer ring
of docs (so that at least they were there, but
maybe with just a basic categorisation) and
as time permits they could be integrated into
the core.

Using a system like this would mean that
right away we'd have a significant body of
text to present to the user community.

The distinction between core and outer
docs should be made clear though, so that
users/authors see that this is a worthwhile
work in progress rather than yet another
random collection of articles.

kim



This archive was generated by hypermail 2.0b3 on Mon Jan 10 2000 - 20:56:29 EST