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-37920-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1Mu899-0002Cq-67
	for garchives@archives.gentoo.org; Sat, 03 Oct 2009 17:11:51 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id C270BE08B1;
	Sat,  3 Oct 2009 17:11:49 +0000 (UTC)
Received: from mail-ew0-f222.google.com (mail-ew0-f222.google.com [209.85.219.222])
	by pigeon.gentoo.org (Postfix) with ESMTP id 882C9E08B1
	for <gentoo-dev@lists.gentoo.org>; Sat,  3 Oct 2009 17:11:49 +0000 (UTC)
Received: by ewy22 with SMTP id 22so1754002ewy.14
        for <gentoo-dev@lists.gentoo.org>; Sat, 03 Oct 2009 10:11:49 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:in-reply-to:references
         :from:date:message-id:subject:to:content-type;
        bh=+vCpG6ndFl2VWo3eheAkZo/G8vtCTnBGHdz6yjJI2Zk=;
        b=wDiSjHmbFUNpTOMPlXAHwPoS92TfJN7TrwjEQUK1r35pdYbz0eEB8iZ+ZknoVCmy3k
         1D6uTHfoDC1A18splBS/VwqUt2IWg7DXmPxwTUD1QMgvDa2VWvwMp0jYt4V6OtsKEmw+
         N8gUN6Vypc66pf+W+tLYOU5zJSxq2b5lCYEVk=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:from:date:message-id:subject:to
         :content-type;
        b=HUatPFEx4pY8c1ZTGnA/CMVR6ySmtxG+KWxoQxvpk429mKk1bzx0klGXdtTkytjp85
         RWKI9vAhnRjUmcTcLgF3InruTT/G0zR5R3M3AwrB5v21ELO+vY77HqPSvYxLWlngZbnd
         Lk7Fqe1JMggqRXClifQku5bf6fUEVKHGvtN8M=
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
Received: by 10.216.72.199 with SMTP id t49mr601017wed.219.1254589905226; Sat, 
	03 Oct 2009 10:11:45 -0700 (PDT)
In-Reply-To: <4AC765A7.6030301@allenjb.me.uk>
References: <4AC765A7.6030301@allenjb.me.uk>
From: N J <raphexion@gmail.com>
Date: Sat, 3 Oct 2009 19:11:25 +0200
Message-ID: <2f80c2df0910031011k5dc60506x7656c6795b9dcb1a@mail.gmail.com>
Subject: Re: [gentoo-dev] Anyone interested in maintaining the Gentoo 
	Handbooks?
To: gentoo-dev@lists.gentoo.org
Content-Type: text/plain; charset=ISO-8859-1
X-Archives-Salt: 0454a4cf-f76a-4e9a-8838-3a6ca700b169
X-Archives-Hash: f62bce2e94c3a84e80fad2bf1586efa1

Hi all,

I made a new install the other week-end and I found a couple of
strange things so I would like to help out. The only problem is that I
am pretty newb so I can only point out small things but i would like
to help. One big thing is that we now use eselect in a lot of cases.

In addition, I must say that we should have a couple of more sample
files, .config, xorg.conf and so on. If we would like to get some new
users, I think we should try to help them out a bit more. Just to get
started.

thanks,
Nik,

On Sat, Oct 3, 2009 at 4:54 PM, AllenJB <gentoo-lists@allenjb.me.uk> wrote:
> Hi all,
>
> The situation with the Gentoo Handbook is quite frankly getting beyond a
> joke for those of us donating our time to help users.
>
> I have tried to bring up the issues on the docs team list but pretty
> much get shot down and told everything is fine and dandy.
>
> For example, quoteth the Handbook at:
> http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5
> Most PC users should use the stage3-i686-2008.0.tar.bz2 stage3 archive.
>
> This results in users starting out with a version of portage that
> doesn't understand EAPI-2. Guess what happens next.
>
> I personally would happily donate my time to working on the docs, if
> only it didn't involve a markup language nobody else uses. I suggested a
> closed wiki for official documentation, but was again shot down saying
> that the existing team (who seem to be doing nothing) would need to
> reskill and that the server admins dislike wikis.
>
> Is it really satisfactory that the official install documentation
> results in a basically non-working install?
>
>
> AllenJB
>
>