Gentoo Archives: gentoo-dev

From: George Prowse <george.prowse@×××××.com>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Re: [RFC] Gentoo Wiki Project
Date: Fri, 09 Apr 2010 17:48:37
In Reply to: Re: [gentoo-dev] Re: [RFC] Gentoo Wiki Project by Zeerak Mustafa Waseem
1 On 09/04/2010 18:24, Zeerak Mustafa Waseem wrote:
2 > On Fri, Apr 09, 2010 at 06:02:40PM +0100, George Prowse wrote:
3 >> On 09/04/2010 13:38, Ben de Groot wrote:
4 >>> On 9 April 2010 13:26, Guy Fontaine<guy.fontaine@××××××××××××.ca> wrote:
5 >>>> There are things I know about Gentoo Linux and I'm pleased to share my knowledge with others as well as I'm glad to learn from others. I'm not a Gentoo dev and I neither have plan nor wish to be.
6 >>>>
7 >>>> My feeling is that Gentoo Wiki Project is just but another occasion for debating rules and politics. Reading some messages from some people I feel like I'm not welcome because I'm not a member of a group of selected people.
8 >>>
9 >>> Don't be dismayed by negative remarks, or a few naysayers who are not
10 >>> even part of the Gentoo Wiki Project. Any user (or dev) with
11 >>> constructive input is welcome. And as you volunteered, you are part of
12 >>> the project.
13 >>>
14 >>> Cheers,
15 >>
16 >> I still dont understand people's problems with this. Several devs have
17 >> said they've wanted one for years, it would be a great place to review
18 >> documentation before going in the official documentation, it's a great
19 >> place to discuss and collaborate on future dev handbook pages.
20 >>
21 >> The official wiki could and *should* work together with the unofficial
22 >> wiki because they complement eachother. The unofficial wiki isn't going
23 >> to want detailed OpenRC documentation and the official wiki isn't going
24 >> to want "how to set up FreeDOOM" on it.
25 >>
26 >
27 > Really? I understood it as the wiki being an all-purposes wiki, meaning users could (would and should) create articles on how to get some application running or how to get some setting working, and the developers will have their own "section", so to speak, where they can collaborate on various projects where a wiki would be an asset.
28 > It seems to me from the discussion here on the list that it is to centralize documentation (- the official docs), so that gentoo can point to the wiki and say "If it's not in our docs, maybe it's in the wiki".
29 >
30 > I may have mistaken the actual purpose of the wiki, but then by all means, correct me :-)
31 >
32 I see it as a collaboration piece, something to bridge the gap between
33 developers and users. Users can create pages detailing certain facets of
34 Gentoo and it may get to be included in the documentation on
36 Some documentation is unfit for an official wiki but that doesn't mean
37 that the information doesn't need to be there for users, that is where
38 the official and unofficial wiki should work together .