Re: [gentoo-dev] Anyone interested in maintaining the Gentoo Handbooks?

[Victor Ostorga <vostorga@gentoo.org>]

On Sat, 03 Oct 2009 15:54:31 +0100
AllenJB <gentoo-lists@allenjb.me.uk> wrote:

> Hi all,
> 
> The situation with the Gentoo Handbook is quite frankly getting
> beyond a joke for those of us donating our time to help users.
> 
> I have tried to bring up the issues on the docs team list but pretty
> much get shot down and told everything is fine and dandy.
> 
> For example, quoteth the Handbook at:
> http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5
> Most PC users should use the stage3-i686-2008.0.tar.bz2 stage3
> archive.
> 
> This results in users starting out with a version of portage that
> doesn't understand EAPI-2. Guess what happens next.
> 
> I personally would happily donate my time to working on the docs, if
> only it didn't involve a markup language nobody else uses. I
> suggested a closed wiki for official documentation, but was again
> shot down saying that the existing team (who seem to be doing
> nothing) would need to reskill and that the server admins dislike
> wikis.
> 
> Is it really satisfactory that the official install documentation
> results in a basically non-working install?
> 

I have seen many users happy with the unofficial wiki idea, and they
have expressed a "official" wiki would be great, and I share the same
idea.

Víctor