Re: [PATCH] Chinese translation of Documentation/HOWTO

[Rob Landley <rob@landley.net>]

On Friday 22 June 2007 05:21:23 Alan Cox wrote:
> > The question is, do the kernel developers want to encourage people who
> > don't speak English to mess with the kernel, any more than they want to
> > encourage kernel developers who don't know C?  Is kernel documentation in
> > Chinese a
>
> The majority of the world population do not speak English. There are
> existing contributors do not speak English (and I'm not being funny about
> the USSA here) - you don't notice because they have a team member who
> speaks passable English.

Ok.  Cool.  If this is not a problem, that's good to know.

> There are also entire non-English sites around things like Linux that
> monoglot English speakers generally don't notice exist.

I'm aware of this.

> > P.S.  The hardest part of putting together a kernel documentation web
> > page is actually indexing it coherently.  It's not very useful to just
> > dump together
>
> For the kernel I would follow the kernel tree so that its always
>
> 	/[languagecode]/Documentation/...

That PS was about putting up a kernel doc web page, not about the existing 
kernel Documentation tree.

The existing Documentation tree has, at the top level, coding style 
guidelines, files documenting the kernel community, a file documenting the 
Amiga "zorro" bus, a half-dozen files about old multiport serial cards, 
documentation about several different types of locking, a penguin graphic 
from 1996, your documentation on the tty layer, a document on how to 
configure BINFMT_MISC to autorun .NET files with mono, and zillions of other 
random unrelated topics that are sorted based on where random passerby put 
things down last.

I sent a couple patches to shuffle stuff around in there but it got lost on 
the noise.  More to the point, an HTML index can hotlink but text files have 
a harder time doing that, so if I'm making an HTML index it's probably best 
to link to the text files but not attempt to navigate with them.

Rob
-- 
"One of my most productive days was throwing away 1000 lines of code."
  - Ken Thompson.