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 [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
[Index of Archives]
[Kernel Newbies]
[Netfilter]
[Bugtraq]
[Photo]
[Stuff]
[Gimp]
[Yosemite News]
[MIPS Linux]
[ARM Linux]
[Linux Security]
[Linux RAID]
[Video 4 Linux]
[Linux for the blind]
[Linux Resources]