Gentoo Archives: gentoo-doc

From: Jose Luis Rivero <yoswink@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Wiki, Take #whatever
Date: Wed, 12 Nov 2008 16:29:31
Message-Id: 491B0452.8050408@gentoo.org
In Reply to: [gentoo-doc] Wiki, Take #whatever by Josh Saddler
1 Josh Saddler wrote:
2 > Hey again. So there's some discussion (again) on starting up an official
3 > Gentoo wiki. Official meaning it's hosted on our infrastructure; e.g.
4 > wiki.gentoo.org. This time the discussion is coming from our fellow
5 > developers and infra overlords.
6 >
7
8 Our fellow developers or infra overlords have seen any problem in how do
9 we work and the status of the current documentation? This list is open
10 to anyone and I haven't read any mail saying so.
11
12 >
13 > However, it's been quite awhile since the last time we (the GDP) talked
14 > it over. Given our current issues of manpower and time (see
15 > archives.gentoo.org for commit totals), perhaps a wiki could solve some
16 > issues?
17
18 Let's face what problems we have in GDP and find a way to solve them.
19 The solution should not bring new problems or make our most powerful
20 features worst.
21
22 > The classic problems are:
23 > 1) Who has access
24 > 2) Who reports faulty articles
25 > 3) Who fixes them
26 > 4) Who verifies the article is correct
27 > 5) ???
28 > 6) Profit
29
30 These problems appear when you are going against wiki principles, may be
31 are you trying to use a wiki for something which was not designed to?
32
33 > So, I'd like to hear what you think. Should we have a wiki? Why or why
34 > not?
35
36 What will be the propose of the wiki? More documentation? Written by
37 anyone and hosted in gentoo.org? Without being sure about its quality
38 first? If so, you have my "no, please".
39
40 > There's no question that having a properly-administered wiki can be a
41 > powerful asset. Look at Ubuntu, Debian, Arch, the Xfce wiki, etc. What
42 > about Gentoo?
43
44 Maybe I'm too ignorant but every time a look to Ubuntu or Debian wiki I
45 wasn't able to be sure about the 'official','review','updated' state of
46 the documentation.
47
48 Summarizing:
49
50 - If you think we have problems in GDP, let's talk about them.
51 - Seems to me that people is thinking of using a wiki not as a result
52 of a process to solve a problem.
53 - I prefer quality over quantity. Every step done shouldn't touch the
54 Gentoo Documentation quality.
55 - If someone is thinking of us involved in the wiki review or admin
56 process and all its fun, please ask first.
57 - If someone is thinking of replacing docs with a wiki, I really
58 dislike the idea.
59
60 Thanks.
61
62 --
63 Jose Luis Rivero <yoswink@g.o>
64 Gentoo/Alpha Gentoo/Doc

Replies

Subject Author
Re: [gentoo-doc] Wiki, Take #whatever wireless <wireless@×××××××××××.com>