lkml.org 
[lkml]   [2007]   [Jun]   [22]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
SubjectRe: [PATCH] Chinese translation of Documentation/HOWTO
Date
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.
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

\
 
 \ /
  Last update: 2007-06-22 20:57    [W:0.086 / U:0.692 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site