1 |
AllenJB wrote: |
2 |
> Hi all, |
3 |
> |
4 |
> The situation with the Gentoo Handbook is quite frankly getting beyond a |
5 |
> joke for those of us donating our time to help users. |
6 |
> |
7 |
> I have tried to bring up the issues on the docs team list but pretty |
8 |
> much get shot down and told everything is fine and dandy. |
9 |
> |
10 |
> For example, quoteth the Handbook at: |
11 |
> http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5 |
12 |
> Most PC users should use the stage3-i686-2008.0.tar.bz2 stage3 archive. |
13 |
> |
14 |
> This results in users starting out with a version of portage that |
15 |
> doesn't understand EAPI-2. Guess what happens next. |
16 |
> |
17 |
> I personally would happily donate my time to working on the docs, if |
18 |
> only it didn't involve a markup language nobody else uses. I suggested a |
19 |
> closed wiki for official documentation, but was again shot down saying |
20 |
> that the existing team (who seem to be doing nothing) would need to |
21 |
> reskill and that the server admins dislike wikis. |
22 |
> |
23 |
> Is it really satisfactory that the official install documentation |
24 |
> results in a basically non-working install? |
25 |
> |
26 |
> |
27 |
> AllenJB |
28 |
> |
29 |
> |
30 |
|
31 |
I always use the x86 Quick install guide [1] I did an amd64 install |
32 |
using it and can not recall changing anything. How about each arch |
33 |
maintaining their own Quick install guide and for more in depth |
34 |
questions point users to irc or the forums and put the handbook in the |
35 |
archives for historical reference if no one wants to keep it current. |
36 |
|
37 |
[1] http://www.gentoo.org/doc/en/gentoo-x86-quickinstall.xml |
38 |
|
39 |
|
40 |
-- |
41 |
David Abbott (dabbott) |
42 |
Gentoo PR |
43 |
Gentoo trustee |