List Archive: gentoo-doc
Josh Saddler wrote:
> Hey again. So there's some discussion (again) on starting up an official
> Gentoo wiki. Official meaning it's hosted on our infrastructure; e.g.
> wiki.gentoo.org. This time the discussion is coming from our fellow
> developers and infra overlords.
>
Our fellow developers or infra overlords have seen any problem in how do
we work and the status of the current documentation? This list is open
to anyone and I haven't read any mail saying so.
>
> However, it's been quite awhile since the last time we (the GDP) talked
> it over. Given our current issues of manpower and time (see
> archives.gentoo.org for commit totals), perhaps a wiki could solve some
> issues?
Let's face what problems we have in GDP and find a way to solve them.
The solution should not bring new problems or make our most powerful
features worst.
> The classic problems are:
> 1) Who has access
> 2) Who reports faulty articles
> 3) Who fixes them
> 4) Who verifies the article is correct
> 5) ???
> 6) Profit
These problems appear when you are going against wiki principles, may be
are you trying to use a wiki for something which was not designed to?
> So, I'd like to hear what you think. Should we have a wiki? Why or why
> not?
What will be the propose of the wiki? More documentation? Written by
anyone and hosted in gentoo.org? Without being sure about its quality
first? If so, you have my "no, please".
> There's no question that having a properly-administered wiki can be a
> powerful asset. Look at Ubuntu, Debian, Arch, the Xfce wiki, etc. What
> about Gentoo?
Maybe I'm too ignorant but every time a look to Ubuntu or Debian wiki I
wasn't able to be sure about the 'official','review','updated' state of
the documentation.
Summarizing:
- If you think we have problems in GDP, let's talk about them.
- Seems to me that people is thinking of using a wiki not as a result
of a process to solve a problem.
- I prefer quality over quantity. Every step done shouldn't touch the
Gentoo Documentation quality.
- If someone is thinking of us involved in the wiki review or admin
process and all its fun, please ask first.
- If someone is thinking of replacing docs with a wiki, I really
dislike the idea.
Thanks.
--
Jose Luis Rivero <yoswink@g.o>
Gentoo/Alpha Gentoo/Doc
|
|