Gentoo Archives: gentoo-doc

From: AllenJB <gentoo-lists@××××××××××.uk>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Wiki, Take #whatever
Date: Tue, 18 Nov 2008 10:19:45
Message-Id: 492296BC.6070307@allenjb.me.uk
In Reply to: Re: [gentoo-doc] Wiki, Take #whatever by wireless
1 Request for clarification:
2 So you're proposing that if I write a good article on the wiki, the
3 Gentoo devs should take that article, XMLify it and put it on the static
4 site where I can't update it easily?
5
6 AllenJB
7
8 wireless wrote:
9 > Jose Luis Rivero wrote:
10 >
11 >>> So, I'd like to hear what you think. Should we have a wiki? Why or why
12 >>> not?
13 >
14 > NO !!!
15 >
16 >> What will be the propose of the wiki? More documentation? Written by
17 >> anyone and hosted in gentoo.org? Without being sure about its quality
18 >> first? If so, you have my "no, please".
19 >
20 >>> There's no question that having a properly-administered wiki can be a
21 >>> powerful asset. Look at Ubuntu, Debian, Arch, the Xfce wiki, etc. What
22 >>> about Gentoo?
23 >
24 >> Maybe I'm too ignorant but every time a look to Ubuntu or Debian wiki I
25 >> wasn't able to be sure about the 'official','review','updated' state of
26 >> the documentation.
27 >
28 >> Summarizing:
29 >> - If you think we have problems in GDP, let's talk about them.
30 >> - Seems to me that people is thinking of using a wiki not as a result
31 >> of a process to solve a problem.
32 >> - I prefer quality over quantity. Every step done shouldn't touch the
33 >> Gentoo Documentation quality.
34 >> - If someone is thinking of us involved in the wiki review or admin
35 >> process and all its fun, please ask first.
36 >> - If someone is thinking of replacing docs with a wiki, I really
37 >> dislike the idea.
38 >
39 > Sorry for the delayed response, I've been unplugged for a while.....
40 >
41 >
42 > After reading the entire thread, a rather simple solution seems
43 > obvious. The GDP or Infra or whatever official group should stay
44 > out of the the wiki business, for many aforementioned reasons.
45 >
46 >
47 > However, if what ever the new wiki(s) pop up for the ashes of any
48 > previous efforts, it seem like a natural place for 'official gentoo
49 > folks' to peruse, parse, filter and/or glean information for good
50 > ideas and (tested) content into one of the existing gentoo
51 > semantics (GDP infra whatever), but leave the morass of a wiki to
52 > the user community at large.
53 >
54 > That way folks could first look to the trunk of Gentoo for docs
55 > on a given subject and if nothing there exist, THEN go to any
56 > of these community wikis.
57 >
58 >
59 > For example, installing a webcam is pretty important and very, very
60 > common among needs for any distro. Yet if you google for webcam,
61 > install and gentoo, you get a variety of 'hash' mostly outdated.
62 >
63 >
64 > Those talent folks within the official gentoo structure, should
65 > recognize this and build docs somewhere, of high quality, that
66 > walk a gentoo user through how to set up a capture card (ntsc/pal)
67 > or a web cam.
68 >
69 > But for every issue that really needs a good doc, there will be
70 > many wikis with a variety of quality, mostly due to the lack of
71 > maintenance over time. Smart folks with lots of current
72 > responsibilities, should stay focused on current goals.
73 >
74 >
75 > However, as the external gentoo wikis mature, but the others
76 > in the gentoo community, folks can glean good idea to increase
77 > the officially maintained docs.
78 >
79 > YMMV,
80 >
81 > James
82 >

Replies

Subject Author
Re: [gentoo-doc] Wiki, Take #whatever Josh Saddler <nightmorph@g.o>