[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Gnumed-devel] GNUmed website

From: David Grant
Subject: Re: [Gnumed-devel] GNUmed website
Date: Mon, 15 Dec 2003 00:19:42 -0500
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-GB; rv:1.5) Gecko/20031121

Ian Haywood wrote:

On Sun, 14 Dec 2003 23:21:50 -0500
David Grant <address@hidden> wrote:
Although I like wiki's, how do you keep manuals updated with the content in the wiki? Wikis are great for doing all sorts of things with, but I don't know how to do a manual in wiki and keep it synchronized with an HTML docbook style manual.
An interesting project......

The people at are likely to come up with a solution
at some point [probably long before we have a user's manual longer than 10 

In the meantime. I think  the advantages
outweigh this problem, as the docs need to be able to evolve quickly and have numerous people work on them. Certainly for the developer's manual we
should move to Wiki, as it's unlikely people will be printing it
out (the main advantage of Docbook)
Good call...this is an awesome idea to develop the manual using a wiki, since you are right; it needs to evolve quickly and there are many people. This would totally reduce the barrier to entry for me, as right now it is not possible (at least not easily) for me to change the manuals. It involves e-mailing people, which is just a waste of everyone's time.

And I just realized, that docs like these usually have very little formatting and can easily be ported to docbook later. And once the project is mature, the docs will evolve more slowly, eliminating the need for the wiki-manual in a way, and someone can just update the docbook one. Or by that time, will have something.

It should be possible to print from a wiki, at least from wikipedia/wikibooks there is a printer-friendly mode.

Only to decide what wiki system to use? I've used phpwiki (I don't like it that much), and twiki (pretty good). Of course I've used wikipedia but I've never actually implemented my own wiki using their code.

On Mon, 15 Dec 2003 15:16:14 +1100
Horst Herb <address@hidden> wrote:
We have to consult with Tony Lembke too, who has done all the hard work with over the past years, to see what his thoughts are.
He has certainly done a lot of excellent work on a user's site, and I'm pleased 
to see it is quite up to
date. It also has an ability to add/edit documents online, but not as flexible 
as a 'true' wiki, I would propose
to make the "Development" link point to the wiki (a common practice on free 
software project sites)



Gnumed-devel mailing list

David J. Grant
M.A.Sc. Candidate in Electrical Engineering
a-Si and Integrated Circuits Lab
University of Waterloo
Room DC3707
519-888-4567 x2872

reply via email to

[Prev in Thread] Current Thread [Next in Thread]