1 |
Nirbheek Chauhan wrote: |
2 |
> On Sat, Oct 3, 2009 at 8:24 PM, AllenJB <gentoo-lists@××××××××××.uk> wrote: |
3 |
>> The situation with the Gentoo Handbook is quite frankly getting beyond a |
4 |
>> joke for those of us donating our time to help users. |
5 |
>> |
6 |
>> I have tried to bring up the issues on the docs team list but pretty |
7 |
>> much get shot down and told everything is fine and dandy. |
8 |
>> |
9 |
>> For example, quoteth the Handbook at: |
10 |
>> http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5 |
11 |
>> Most PC users should use the stage3-i686-2008.0.tar.bz2 stage3 archive. |
12 |
>> |
13 |
>> This results in users starting out with a version of portage that |
14 |
>> doesn't understand EAPI-2. Guess what happens next. |
15 |
>> |
16 |
>> I personally would happily donate my time to working on the docs, if |
17 |
>> only it didn't involve a markup language nobody else uses. |
18 |
> |
19 |
> You're in luck, the Beacon project has perfected it's Django branch |
20 |
> which is now nearly ready for deployment. I think this is a far better |
21 |
> option than converting all of the existing XML docs into Wiki and |
22 |
> alienating an entire team. |
23 |
> |
24 |
What is the Beacon project? URL? A tried a quick bit of googling but |
25 |
came up with nothing useful. |
26 |
|
27 |
What entire team? Part of the problem is that there appears to be no one |
28 |
working on the docs to start with. There's been a bug open on the 2008.0 |
29 |
-> autobuilds change open since February with, as far as I can tell, |
30 |
nothing at all done towards fixing the handbooks. ( |
31 |
http://bugs.gentoo.org/260403 ) |
32 |
|
33 |
The last comment on that bug by a docs team member basically says: |
34 |
> All the doc they need is 'Boot CD, follow on-screen instruction. If it fails, |
35 |
> file a bug for the release team'. Done. |
36 |
> |
37 |
> Now, can we all forget abouth them? |
38 |
|
39 |
Which I think is a very poor attitude for someone tasked with |
40 |
maintaining the documentation (and appears to totally ignore the fact |
41 |
that the abomination of an installer the GLI was has been long dead and |
42 |
buried, even when that comment was made). |
43 |
|
44 |
Just because you very rarely reinstall Gentoo, and once you've done it a |
45 |
few times it's easy to do off-by-heart, that doesn't mean it should be |
46 |
impossible for new users to ever install Gentoo for the first time. I |
47 |
believe the Gentoo Handbook is a great, essential guide for new Gentoo |
48 |
users - if only the install section actually worked! |
49 |
|
50 |
AllenJB |