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-50679-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1SCc6n-000896-3U
	for garchives@archives.gentoo.org; Tue, 27 Mar 2012 19:31:09 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id AC0A9E0895;
	Tue, 27 Mar 2012 19:30:35 +0000 (UTC)
Received: from mail-ob0-f181.google.com (mail-ob0-f181.google.com [209.85.214.181])
	by pigeon.gentoo.org (Postfix) with ESMTP id 0D1FFE0833
	for <gentoo-dev@lists.gentoo.org>; Tue, 27 Mar 2012 19:29:36 +0000 (UTC)
Received: by obceq6 with SMTP id eq6so295685obc.40
        for <gentoo-dev@lists.gentoo.org>; Tue, 27 Mar 2012 12:29:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=sender:date:from:to:subject:message-id:mail-followup-to:references
         :mime-version:content-type:content-disposition:in-reply-to
         :user-agent;
        bh=QP2ZlkjVbq9OnBapx1rqDvue4Bfv8Q2ORA+BjyAs0GM=;
        b=X1Ly8n6cHucAFykbooHEvuVD4lWW67zh7qVGtkbg05JXsNZWw/C0Lk+4xidwNG13sb
         dvsBEaeFII8qwpKpVKDjMa2u3lYQIvceSicieMNrzQ7HkPfAKrBxCliJFuINUzAUTBA2
         jvt/fdOecbm8ijLfsZZSVVmnrdNwbZTXQJE+VbaMDn+g8D3lQcNWVGTCsxEHEVZjhZrI
         +cmnCrqGxMcUF9zk4OlTLrY5kQclImeK4OpJZ2H+kz793efDcAw5hl4Mj0Lxg+yWNPSD
         XKJWrH/SEk+CoGPS9ng1UDLOaCms33Wx174xVwKfxeZYDhkHKKVeogUbG+H6eKW2SJQe
         0NSg==
Received: by 10.182.1.104 with SMTP id 8mr34264165obl.19.1332876576496;
        Tue, 27 Mar 2012 12:29:36 -0700 (PDT)
Received: from linux1 (cpe-76-187-77-158.tx.res.rr.com. [76.187.77.158])
        by mx.google.com with ESMTPS id yw3sm744386obb.7.2012.03.27.12.29.34
        (version=SSLv3 cipher=OTHER);
        Tue, 27 Mar 2012 12:29:36 -0700 (PDT)
Sender: William Hubbs <w.d.hubbs@gmail.com>
Received: by linux1 (sSMTP sendmail emulation); Tue, 27 Mar 2012 14:29:34 -0500
Date: Tue, 27 Mar 2012 14:29:34 -0500
From: William Hubbs <williamh@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] About suggesting to create a separate partition for
 portage tree in handbook
Message-ID: <20120327192934.GA6936@linux1>
Mail-Followup-To: gentoo-dev@lists.gentoo.org
References: <20337.28987.736877.961717@a1i15.kph.uni-mainz.de>
 <20120327154239.GA17394@gentoo.org>
 <1332870540.18466.9.camel@belkin4>
 <20120327180158.GA1468@siphos.be>
 <1332873243.11827.15.camel@rook>
 <CAGfcS_n2qUHpWF+_YvS+wB7-ntH+yvJUd7T1=nn32U1+c4CLMQ@mail.gmail.com>
 <20120327191503.GF17394@gentoo.org>
 <CAATnKFDbVmxpDoRY=7nPMb+-wHM6tFA2iB_y=vH8wTWSE6-awQ@mail.gmail.com>
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
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="OXfL5xGRrasGEqWY"
Content-Disposition: inline
In-Reply-To: <CAATnKFDbVmxpDoRY=7nPMb+-wHM6tFA2iB_y=vH8wTWSE6-awQ@mail.gmail.com>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Archives-Salt: b7f7bdc9-bd14-49e2-bda9-fe9a6269c7bc
X-Archives-Hash: 4e95001ad9a4f2dc81c50f4ab91f7fe7


--OXfL5xGRrasGEqWY
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Mar 28, 2012 at 08:20:45AM +1300, Kent Fredric wrote:
> On 28 March 2012 08:15, Sven Vermeulen <swift@gentoo.org> wrote:
> >> Then again, Gentoo is about choice. =A0It just seems like we're
> >> presenting users with more choices than makes sense for a newbie. =A0If
> >> there is a choice between something that 99.99% of users will want,
> >> and some ancient piece of cruft that still works and is better for
> >> 0.01% of the userbase, does that really have to be in the handbook?
> >
> > Welcome to documentation development. The Gentoo Handbook has always be=
en a
> > difficult source for such discussions. If we truely want to provide
> > information towards our users on all possible choices, you'll need a to=
tally
> > different approach.
> >
> > I once started (before I left Gentoo, rejoined, left again) on a "compl=
ete
> > gentoo handbook" that covered much more in greater detail (you'll find =
the
> > last version at
> > http://www.gentoo.org/doc/en/handbook/draft/complete/handbook.xml) but =
I've
> > since moved away from that. Perhaps I should work again on it...
> >
> > Wkr,
> > =A0 =A0 =A0 =A0Sven Vermeulen
> >
>=20
>=20
> An idea is a javascripty-dynamic-slidey thing that makes more details
> and advanced stuff visible to people who want it, so you can adjust
> the documentation to suit your skill level.

Why not just the separate "quick install" guide like we have that lists
steps and the handbook if yu want more details?

William

--OXfL5xGRrasGEqWY
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk9yFR4ACgkQblQW9DDEZTiF2QCfYkVGSKFKggswxONxOKt1ZOBh
osgAn1mWSrcuHXOJVthEMfQmTGxvNnDZ
=Ov+K
-----END PGP SIGNATURE-----

--OXfL5xGRrasGEqWY--