DragonFly BSD
DragonFly docs List (threaded) for 2004-11
[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]

Re: Wiki-fying docs


From: Jeroen Ruigrok/asmodai <asmodai@xxxxxx>
Date: Mon, 29 Nov 2004 07:10:38 +0100

-On [20041129 05:52], Justin C. Sherrill (justin@xxxxxxxxxxxxxxxxxx) wrote:
>I've noticed that there's been a number of people who have wanted to
>contribute to docs, but the process of installing the doc-proj port and
>all its dependencies, plus talking SGML, plus building it, is forming a
>sort of barrier to entry.  I think I'm the only poor soul that's done it.

I have totally switched to XML in favour of SGML.  Much better for one's
sanity.

>I was thinking we could copy the existing docs into a Wiki, and see how
>contributions change from there.  Mashing wiki changes back into CVS may
>be less laborious than putting other people through the docproj wringer. 
>Can anyone think of any objections?

I've dabbled/done the wiki route.  Fun stuff, but if you are even thinking
of putting out printed documentation do not bother since it is not a fun
exercise to convert that data.

Plus I found that with most wikis the amount of linking to/from a page using
keywords can become quite a nuisance/distraction for someone reading the
documentation.

But that's just opinion.

-- 
Jeroen Ruigrok van der Werven <asmodai(at)wxs.nl> / asmodai / kita no mono
Free Tibet! http://www.savetibet.org/ | http://ashemedai.deviantart.com/
http://www.tendra.org/   | http://www.in-nomine.org/
We must believe in ourselves and in our dreams.  For all is not lost.
We have only to stand straight and tall, knowing ourselves to be no less
than those who came before us.  And we must never loose hope, never,
never, never . . .



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