Gentoo Logo
Gentoo Spaceship

Installation:
Gentoo Handbook
Installation Docs

Documentation:
Home
Listing
About Gentoo
Philosophy
Social Contract

Resources:
Bug Tracker
Developer List
Discussion Forums
Gentoo BitTorrents
Gentoo Linux Enhancement Proposals
IRC Channels
Mailing Lists
Mirrors
Name and Logo Guidelines
Online Package Database
Security Announcements
Staffing Needs
Supporting Vendors
View our CVS

Graphics:
Logos and themes
Icons
ScreenShots

Miscellaneous Resources:
Gentoo Linux Store
Gentoo-hosted projects
IBM dW/Intel article archive




List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Jose Luis Rivero <yoswink@g.o>
Subject: Re: Wiki, Take #whatever
Date: Wed, 12 Nov 2008 17:29:06 +0100
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


Replies:
Re: Wiki, Take #whatever
-- wireless
References:
Wiki, Take #whatever
-- Josh Saddler
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Wiki, Take #whatever
Next by thread:
Re: Wiki, Take #whatever
Previous by date:
Re: Re: Wiki, Take #whatever
Next by date:
Re: Re: Wiki, Take #whatever


Updated Jun 17, 2009

Donate to support our development efforts.

Gentoo Centric Hosting: vr.org

VR Hosted

Tek Alchemy

Tek Alchemy

SevenL.net

SevenL.net

php|architect

php|architect

Copyright 2001-2007 Gentoo Foundation, Inc. Questions, Comments? Email www@gentoo.org.