Gentoo Archives: gentoo-project

From: Rich Freeman <rich0@g.o>
To: gentoo-project@l.g.o
Cc: Docs Team <docs-team@g.o>
Subject: Re: [gentoo-project] improving alternative PM support in gentoo
Date: Tue, 18 Aug 2015 01:18:13
Message-Id: CAGfcS_k7aobAoVA6YLUCLpOF-WV4qOaovwGwE65+sDeFVVxnUw@mail.gmail.com
In Reply to: Re: [gentoo-project] improving alternative PM support in gentoo by Ben de Groot
1 On Mon, Aug 17, 2015 at 3:26 AM, Ben de Groot <yngwin@g.o> wrote:
2 >
3 > But I would like to keep the Handbook as such simple. It is
4 > overwhelming enough as it is, for newcomers, so let's not overload it
5 > with explanations of alternatives. I think we should just offer one
6 > default path, and point to alternatives that are documented in other
7 > parts of the wiki. (This should also be done, for example, with the
8 > part about LILO.)
9 >
10
11 I think that there are parts that could be broken up or organized a
12 bit more cleanly, but I like having the options right in the flow of
13 the document. If you're not going to deviate from the defaults then
14 there isn't a lot of point in running Gentoo in the first place.
15 Also, if we're only going to present one option at each step, I can
16 forsee a LOT of griping on this list about whatever that ONE option
17 ends up being. Some of those choices cause 100-email threads fairly
18 regularly even when they're just one option of many.
19
20 However, breaking things up a bit differently would probably help.
21 Anytime there is a choice to be made it wouldn't hurt to have an
22 introductory section that summarizes the choices and perhaps some
23 neutral pros/cons. Then have links to skip to the next step for each
24 of those choices. Then the next common step should start on a new
25 page, so that users aren't hunting all over the place for what comes
26 next or missing steps.
27
28 --
29 Rich

Replies