Gentoo Archives: gentoo-dev

From: Bjoern Michaelsen <bjoern.michaelsen@×××××.net>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] RFC: Dev-only Wiki for eclasses/portage
Date: Fri, 28 May 2004 03:51:25
Message-Id: 20040528030325.GA13966@lord.sinclair
In Reply to: Re: [gentoo-dev] RFC: Dev-only Wiki for eclasses/portage by Drake Wyrm
1 On Thu, May 27, 2004 at 07:21:08PM -0700, Drake Wyrm wrote:
2 > Would a dev-only wiki actually be any better than the documentation
3 > threads in the forums? Only the thread owner/maintainer can change the
4 > head entry, but everybody (devs and non-devs) can contribute by adding
5 > to the thread.
6 The forums are way to big - it is not easy to actually find
7 something about some general topic. The forums are great for
8 emergency bugfixing and newbie-help (ebuild xy broke my system,
9 how do I fix it) for someone who cant find the answer on IRC,
10 however they fail on general topics. The reason is simple:
11 Outdated information does not get deleted. This is a problem
12 for outdated info in threads and threads that are completly
13 outdated. Completely outdated threads clutter the searches. And a
14 thread over 13 pages fixing a problem (like getting a video-card
15 running) isnt helpful at all, if the reader has to read though
16 13 pages and remember which information is good and which got
17 changed on the way through the thread ... Someone updating info
18 in a wiki has the possibility to remove deprecated info. Also
19 contradicting informations gets spotted easier and can get
20 synced. Just look at the forums - the redundancy in asked
21 questions is pretty high. A good indicator that the information
22 needed might be there, but simply cant be found.
23 A wiki using templates (like moinmoin) also can provide a basic
24 structure/hierachy, while the forums are rather flat.
25 Yours,
26
27 Björn
28
29 --
30 Björn Michaelsen
31 pub 1024D/C9E5A256 2003-01-21 Björn Michaelsen <bmichaelsen@×××.de>
32 Key fingerprint = D649 8C78 1CB1 23CF 5CCF CA1A C1B5 BBEC C9E5 A256