From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-dev+bounces-40418-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1Ny3GG-0003er-83
	for garchives@archives.gentoo.org; Sat, 03 Apr 2010 13:19:40 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 3690CE0B0F;
	Sat,  3 Apr 2010 13:19:36 +0000 (UTC)
Received: from mail-bw0-f210.google.com (mail-bw0-f210.google.com [209.85.218.210])
	by pigeon.gentoo.org (Postfix) with ESMTP id E7F02E08C9
	for <gentoo-dev@lists.gentoo.org>; Sat,  3 Apr 2010 13:19:21 +0000 (UTC)
Received: by bwz2 with SMTP id 2so2340507bwz.10
        for <gentoo-dev@lists.gentoo.org>; Sat, 03 Apr 2010 06:19:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:sender:received:date
         :x-google-sender-auth:received:message-id:subject:from:to
         :content-type;
        bh=eLmmhyZUaWNSfbuKFcFS9iq7mGGgzOFj4CgHysFvSKQ=;
        b=skWfKuLpm7g8QGH4wJPV6KUHZ4IdtKAeGfR+p0d/gVYfni5AawAg/usYAugYRoOlii
         EXkwwcSyZaKgvS+JXSVxqJZSo87+FNk5jKmo7g4lJ1INw8EI7ScHtjsis9ROd67PTlie
         iEIYoTG5zAieUhnKCAp6g5NZapgMy68W+m5wg=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:sender:date:x-google-sender-auth:message-id:subject
         :from:to:content-type;
        b=Ud206xiHMl9MJTqMD0A7/sKDKm0bze+gi+OvpQfY5lO4/tcmE6/FvCM/Fi13C7yqX3
         AWcAKweAl7mmDRRNVwY2tMjDcPQGSEbIPd3oRTM4Z3NFlpvsu3FM0W5bvhEtegxPDzJS
         TNxjMdtd4bh2SqSFmfgNTotKfkuZfwO0tKkBI=
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
Sender: yngwin.gentoo@gmail.com
Received: by 10.204.33.199 with HTTP; Sat, 3 Apr 2010 06:19:20 -0700 (PDT)
Date: Sat, 3 Apr 2010 15:19:20 +0200
X-Google-Sender-Auth: 639001893373eee1
Received: by 10.204.25.209 with SMTP id a17mr4346697bkc.28.1270300760796; Sat, 
	03 Apr 2010 06:19:20 -0700 (PDT)
Message-ID: <s2re117dbb91004030619ka3a39c44wf0a29437f5b050c5@mail.gmail.com>
Subject: [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki
From: Ben de Groot <yngwin@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Content-Type: text/plain; charset=UTF-8
X-Archives-Salt: 48044333-a3a7-411e-92df-fcbdd597555c
X-Archives-Hash: bb48c37927412b254e86a4917d6804d8

On 3 April 2010 11:46, Patrick Lauer <patrick@gentoo.org> wrote:
> On 04/03/10 11:16, Tobias Scherbaum wrote:
>> People are constantly asking for a documentation wiki, but ...
> yeah, as long as no one just creates a wiki there won't be one. People
> are waiting on other people, who are waiting for Godot. Just do it.
>
> I remember the long and whiny road to get a blog aggregator - what
> killed the waiting deadlock was simply karltk setting up one (unofficial
> etc.etc.) and suddenly people saw that it was good.


Okay, so it seems a lot of people do want a wiki. So let's see what
we can do to make that happen.

1 - requirements
================

In order to choose the best possible wiki implementation, we need to
know our requirements. So what features do you think are essential or
good to have? What syntax would we prefer to use?

I myself am a big fan of reStructuredText, which is quite simple,
easy to pick up, highly readable, and has a good featureset. Plus, it
is also reusable in other contexts (it is for example widely used in
documentation of Python libraries). MediaWiki, MoinMoin and Trac have
support for rst.

Some others:

- active upstream (bug fixes, security updates)
- free open source software
- ACLs
- spam prevention measures
- attachments (to upload screenshots for example)
- feeds

Other distros and open source projects surely have had the same
considerations. Can we find out and learn from them?


2 - maintainers
===============

Who is volunteering for maintaining the wiki? We need editors and
moderators, people who look out for quality control and take care of
spam removal. So let's get together a team. I'm sure if we ask on the
forums we'll get some users interested as well.


3 - edit access
===============

Do we keep to the original "free for all" model, with all the spam
that includes, or do we go with registered users only? I think the
latter is the smarter option. I also think we will want to mark
certain pages "official" and lock down editing rights.


Is there anything else we should consider before getting started?

Cheers,
-- 
Ben de Groot
Gentoo Linux Qt project lead developer