Re: Using wiki to encourage users to contribute to documentation.
On Sun, 2003-07-06 at 01:15, Andrew Ballantine wrote:
> I agree that a Wiki could very easily get out of control if not
> supervised, but moderated sensitively it could produce some excellent
> results.Not only could a Wiki environment be used to document existing
> versions of the system, it could be used by users to define how they
> would like the next version to behave.
I think there should be some release cycle with two versions of the
document.
stable -- static not editable, with links to the current dev version
|
| \
| in developement -- wiki style editable by everyone
| /
|
next stable version
So there might be some maintainers which have to look at the quality of
the static version.
> I also appreciate that the choice of wiki engine is critical to give
> the right control and the ability to convert the content to the
> desired mark-up language for easy processing to other document types.
An export format is either debiandoc or the new subset of docbook
discussed on this list.
> I would be interested to hear your comments, objections or
> encouragement in such a scheme. I would be prepared to host a web site
> for this purpose and to moderate it with the help of your good selves.
At the beginning you can have a look at http://wiki.debian.net . The
wiki is based on KWiki(http://www.perl.com/pub/a/2003/05/14/kwiki.html).
Its engine is written in perl and easy to extend. Maybe you can add the
wanted functionality there.
Regards
--
Peter Hoffmann
Reply to: