public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-dev] Anyone interested in maintaining the Gentoo Handbooks?
@ 2009-10-03 14:54 AllenJB
  2009-10-03 15:25 ` Victor Ostorga
                   ` (6 more replies)
  0 siblings, 7 replies; 17+ messages in thread
From: AllenJB @ 2009-10-03 14:54 UTC (permalink / raw
  To: gentoo-dev

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?


AllenJB



^ permalink raw reply	[flat|nested] 17+ messages in thread

end of thread, other threads:[~2009-10-04 10:29 UTC | newest]

Thread overview: 17+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-10-03 14:54 [gentoo-dev] Anyone interested in maintaining the Gentoo Handbooks? AllenJB
2009-10-03 15:25 ` Victor Ostorga
2009-10-03 16:07 ` Nirbheek Chauhan
2009-10-03 17:03   ` AllenJB
2009-10-03 17:51     ` [gentoo-dev] " Duncan
2009-10-03 21:17     ` [gentoo-dev] " Nandeep Mali
2009-10-03 16:17 ` David Abbott
2009-10-03 17:32   ` Dawid Węgliński
2009-10-03 17:45     ` Markos Chandras
2009-10-04  1:13       ` Joshua Saddler
2009-10-04 10:28         ` Richard Freeman
2009-10-03 17:11 ` N J
2009-10-03 18:57 ` Joseph Jezak
2009-10-03 20:14 ` [gentoo-dev] " Ryan Hill
2009-10-03 23:44 ` [gentoo-dev] " Joshua Saddler
2009-10-03 23:58   ` AllenJB
2009-10-04  0:54     ` Joshua Saddler

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox