Re: [gentoo-dev] Decision to remove stage1/2 from installation documentation

[Chris Gianelloni <wolf31o2@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 2305 bytes --]

On Tue, 2005-11-22 at 13:28 -0600, Grant Goodyear wrote:
> > The point is that following the proper steps, one *can* get the exact
> > same output.  This would include using --newuse and cleaning out unused
> > packages, along with any other maintenance items that would be required.
> 
> That's fine with me.  All I really want to do is ensure that we preserve
> our users' ability to tinker with system without making life too painful
> for them.  Starting from a stage 1 it was obvious how to do such
> tinkering.  I would argue that it's not quite as obvious how to do that
> when starting from a stage 3, so a bit of additional documentation on
> how to do that would be nice.  If that were done, then I would have no
> complaints about the stage 1 and stage 2 tarballs going away altogether.

That's kinda what I am shooting for down the line.

The idea was to move out the stage1/stage2 docs to somewhere else.  Then
create some sort of "Advanced Installation Topics" guide or something,
to list out the replacement procedures for customizing a system from a
stage3 tarball, then, eventually, drop the stage1 and stage2 tarballs.
I was working on the idea of doing it all in stages.  The "problem"
occurred from people freaking out because they didn't bother reading the
entire news blurb that tells exactly where the instructions moved to,
plus links to the bug # and discussion.  There's also this nice section
in the Handbook.

"A stage3 tarball is an archive containing a minimal Gentoo environment,
suitable to continue the Gentoo installation using the instructions in
this manual. Previously, the Gentoo Handbook described the installation
using one of three stage tarballs. While Gentoo still offers stage1 and
stage2 tarballs, the official installation method uses the stage3
tarball. If you are interested in performing a Gentoo installation using
a stage1 or stage2 tarball, please read the Gentoo FAQ on How do I
Install Gentoo Using a Stage1 or Stage2 Tarball?"

Really, everybody is just up in arms over a knee-jerk reaction to not
reading carefully.  What it boils down to is either not knowing the
facts, or trolling/flaming.

-- 
Chris Gianelloni
Release Engineering - Strategic Lead
x86 Architecture Team
Games - Developer
Gentoo Linux

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]