| 1 |
On Thu, 2007-05-31 at 20:04 -0700, Ted Kosan wrote: |
| 2 |
> I think that the current documentation that Nightmorph has put together is well |
| 3 |
> suited to more experienced users. For example, I like the different paths that |
| 4 |
> the documentation present at various points because it allows me to see |
| 5 |
> alternatives that I often did not know existed. |
| 6 |
> |
| 7 |
> Instead of replacing the handbook, or radically altering it, my intent with the |
| 8 |
> newbie materials is to have a newbie use them to successfully install Gentoo |
| 9 |
> and then they should blow their installation away and do a reinstall from |
| 10 |
> scratch using the normal Handbook. |
| 11 |
|
| 12 |
See, here's the funny thing about the Handbook. We can never please |
| 13 |
everybody. The Handbook used to be a single document. There were many |
| 14 |
problems with new users being confused by all of the choices presented |
| 15 |
to them in the Handbook, so the arch-specific items were moved into |
| 16 |
arch-specific files and the networkless Handbook was split from the |
| 17 |
networked Handbook. Now people are talking about merging them again, |
| 18 |
which seems like a serious step backwards. |
| 19 |
|
| 20 |
Why not just rename the "2007.0 Handbook" into the "2007.0 Networkless |
| 21 |
Installation Guide" or something similar? After all, the versioned |
| 22 |
Handbooks are only good for the release they correspond to and it won't |
| 23 |
mean going back to having a single and confusing Handbook. All that is |
| 24 |
really needed is a link to the networkless guide for people to follow if |
| 25 |
they're planning on a networkless install, assuming it isn't there |
| 26 |
already. |
| 27 |
|
| 28 |
-- |
| 29 |
Chris Gianelloni |
| 30 |
Release Engineering Strategic Lead |
| 31 |
Alpha/AMD64/x86 Architecture Teams |
| 32 |
Games Developer/Council Member/Foundation Trustee |
| 33 |
Gentoo Foundation |
Archives