Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Paul Waring <paul@...>
Subject: Re: Stage1/2 deprecation from Gentoo Handbook
Date: Mon, 7 Nov 2005 10:22:35 +0000
On Sun, Nov 06, 2005 at 12:13:36AM +0100, Sven Vermeulen wrote:
> The Gentoo Release Engineering team is pushing us to remove stage1 and
> stage2 references from the Gentoo Handbook. They are getting too many errors
> because the user is not able to fully comprehend the implications of a
> stage1 or stage2 installation.

I don't mind the stage 1/2 stuff being removed from the main handbook,
as I can see how those instructions could easily confuse new people.
However, I'd be pretty annoyed to say the least if that documentation
wasn't at least reproduced elsewhere, because how else are people
supposed to be able to do a stage 1/2 install? If a lack of maintainers
is the problem, I'm happy to help out with that area of the
documentation and keep it up to date based on user comments.

As for newbies not wanting to know this sort of stuff - the first time I
used Gentoo (admittedly it wasn't my first experience with Linux by a
long shot though) I did a stage 1 install following the instructions
from the handbook and I found the process to be a good learning
experience. Yes, people will run into problems if they do a stage 1
install (I know I have on several occasions), but we learn a lot more
from our mistakes than we do from something that just works first time.

When one of the key complaints about Linux is that the documentation is
often lacking, I'm surprised to see a distro with some of the best
manuals considering doing away (or at least hiding somewhere else) with
parts of it.

Paul

-- 
Rogue Tory
http://www.roguetory.org.uk
-- 
gentoo-doc@g.o mailing list


Replies:
Re: Stage1/2 deprecation from Gentoo Handbook
-- Jason Stubbs
References:
Stage1/2 deprecation from Gentoo Handbook
-- Sven Vermeulen
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Stage1/2 deprecation from Gentoo Handbook
Next by thread:
Re: Stage1/2 deprecation from Gentoo Handbook
Previous by date:
Re: Stage1/2 deprecation from Gentoo Handbook
Next by date:
Re: Stage1/2 deprecation from Gentoo Handbook


Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.