Gentoo Archives: gentoo-project

From: Ben de Groot <yngwin@g.o>
To: gentoo-project <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 05:22:57
Message-Id: CAB9SyzRsaD2mhbeFavpOXhsgdO0TpMNwjaVvejLLJ_pHLbKrFw@mail.gmail.com
In Reply to: Re: [gentoo-project] improving alternative PM support in gentoo by Rich Freeman
1 On 18 August 2015 at 09:18, Rich Freeman <rich0@g.o> wrote:
2 > On Mon, Aug 17, 2015 at 3:26 AM, Ben de Groot <yngwin@g.o> wrote:
3 >>
4 >> But I would like to keep the Handbook as such simple. It is
5 >> overwhelming enough as it is, for newcomers, so let's not overload it
6 >> with explanations of alternatives. I think we should just offer one
7 >> default path, and point to alternatives that are documented in other
8 >> parts of the wiki. (This should also be done, for example, with the
9 >> part about LILO.)
10 >>
11 >
12 > However, breaking things up a bit differently would probably help.
13 > Anytime there is a choice to be made it wouldn't hurt to have an
14 > introductory section that summarizes the choices and perhaps some
15 > neutral pros/cons. Then have links to skip to the next step for each
16 > of those choices. Then the next common step should start on a new
17 > page, so that users aren't hunting all over the place for what comes
18 > next or missing steps.
19
20 Yes, this is a sensible way to do it.
21
22 --
23 Cheers,
24
25 Ben | yngwin
26 Gentoo developer