On Mon, Aug 21, 2017 at 7:08 AM, Ralph Seichter <m16+gen...@monksofcool.net> wrote: > On 21.08.2017 13:49, mad.scientist.at.la...@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.
