Re: [gentoo-user] install under centos606

[R0b0t1 <r030t1@gmail.com>]

On Mon, Aug 21, 2017 at 7:08 AM, Ralph Seichter
<m16+gentoo@monksofcool.net> wrote:
> On 21.08.2017 13:49, mad.scientist.at.large@tutanota.com wrote:
>
>> I'm excited about using gentoo, though the online instructions could
>> really use more structuring, i.e. it's hard to avoid reading the parts
>> you don't need to and the "flow" is rather lost. It's an extremely
>> verbose document which makes it very hard to get the gist of the install
>> procedure. it's not a bad document, merely poorly organized. [...]
>
> I completely disagree. I consider the Gentoo installation documentation
> well structured, easy to follow and precise, and I don't know what your
> statements like "most newbies would be helplessly confused" are supposed
> to be based on. Please don't try to pass on your personal opinions as
> facts without providing any proof. Show us a control group of newbies,
> most of them helplessly confused, if you can. ;-)
>

I think most of the problem is all the handbook does is give you a
working system in the technical sense. Everything else is up to you to
discover, which can be very hard if you are lacking terminology or
very specific experience.

A good example of a more fully featured guide is Sakaki's EFI
Installation Guide
(https://wiki.gentoo.org/wiki/Sakaki's_EFI_Install_Guide). I have
proposed the handbook be updated, at least on an architecture-specific
basis, to reflect common installation options (as was it seems was
originally intended). However, the Handbook team seems very
conservative and hard to contact.

Among my suggestions were transferring the Handbook to Gollum, so the
pages could be managed from Git. Porting the whole Wiki to Gollum
might make it hard for normal users to contribute, but I suspect only
particularly adept users would have good contributions to the
Handbook.

R0b0t1.