Gentoo Archives: gentoo-dev

From: Victor Ostorga <vostorga@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Anyone interested in maintaining the Gentoo Handbooks?
Date: Sat, 03 Oct 2009 15:28:54
Message-Id: 20091003092543.259f39db@bit
In Reply to: [gentoo-dev] Anyone interested in maintaining the Gentoo Handbooks? by AllenJB
1 On Sat, 03 Oct 2009 15:54:31 +0100
2 AllenJB <gentoo-lists@××××××××××.uk> wrote:
3
4 > Hi all,
5 >
6 > The situation with the Gentoo Handbook is quite frankly getting
7 > beyond a joke for those of us donating our time to help users.
8 >
9 > I have tried to bring up the issues on the docs team list but pretty
10 > much get shot down and told everything is fine and dandy.
11 >
12 > For example, quoteth the Handbook at:
13 > http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5
14 > Most PC users should use the stage3-i686-2008.0.tar.bz2 stage3
15 > archive.
16 >
17 > This results in users starting out with a version of portage that
18 > doesn't understand EAPI-2. Guess what happens next.
19 >
20 > I personally would happily donate my time to working on the docs, if
21 > only it didn't involve a markup language nobody else uses. I
22 > suggested a closed wiki for official documentation, but was again
23 > shot down saying that the existing team (who seem to be doing
24 > nothing) would need to reskill and that the server admins dislike
25 > wikis.
26 >
27 > Is it really satisfactory that the official install documentation
28 > results in a basically non-working install?
29 >
30
31 I have seen many users happy with the unofficial wiki idea, and they
32 have expressed a "official" wiki would be great, and I share the same
33 idea.
34
35 Víctor